Docker Images

Deploy any Docker image to Basepod.

Quick Deploy

bp create myapp
bp deploy myapp --image nginx:latest

From Docker Hub

# Official images
bp deploy myapp --image postgres:16
bp deploy myapp --image redis:7-alpine
bp deploy myapp --image node:20-slim

# Community images
bp deploy myapp --image linuxserver/plex

From Other Registries

GitHub Container Registry

bp deploy myapp --image ghcr.io/username/image:tag

Google Container Registry

bp deploy myapp --image gcr.io/project/image:tag

Private Registries

Configure credentials in server settings, then:

bp deploy myapp --image registry.example.com/image:tag

Image Tags

Specific Versions

bp deploy myapp --image nginx:1.25.3
bp deploy myapp --image postgres:16.2

Latest

bp deploy myapp --image nginx:latest

Alpine Variants (smaller)

bp deploy myapp --image nginx:alpine
bp deploy myapp --image node:20-alpine

Environment Variables

Pass environment variables during deployment:

bp deploy myapp --image postgres:16 \
  -e POSTGRES_USER=admin \
  -e POSTGRES_PASSWORD=secret \
  -e POSTGRES_DB=mydb

Or in basepod.yaml:

name: myapp
image: postgres:16
env:
  POSTGRES_USER: admin
  POSTGRES_PASSWORD: secret
  POSTGRES_DB: mydb

Volumes

Persist data with volumes:

name: myapp
image: postgres:16
volumes:
  - pgdata:/var/lib/postgresql/data

Port Mapping

Specify the container port:

bp deploy myapp --image myimage --port 8080

Or in config:

name: myapp
image: myimage
port: 8080

Resource Limits

Set memory and CPU limits:

name: myapp
image: myimage
resources:
  memory: 512m
  cpus: 1.0

Updating Images

Pull the latest version and restart:

bp deploy myapp --image nginx:latest

Or with a new tag:

bp deploy myapp --image nginx:1.26