Deploy from Docker Image

Deploy any public or private Docker image directly on PodCubo.

When to Use

Use image deploy when:

• You already have a built image published to a registry (Docker Hub, GitHub Container Registry, etc.)
• You want to use a third-party image (e.g., nginx, wordpress, ghost)
• Your CI/CD pipeline already produces the image and you just want to host it

Creating the App

1. Go to your stack and click New App
2. Select App as the type
3. Choose Container Image as the source
4. Enter the image name

Image Name Format

# Docker Hub (official)
nginx:alpine
postgres:16

# Docker Hub (user)
myuser/my-app:latest

# GitHub Container Registry
ghcr.io/myuser/my-app:v1.0

# Custom registry
registry.example.com/my-app:latest

Port

Set the port the container exposes. Check the image documentation to find the correct port.

Environment Variables

Many images require environment variables to function. You can configure them in the Environment Variables section of the app.

Private Registry

If your image is in a private registry:

1. Go to Registries in the main menu
2. Add your registry with access credentials
3. When creating the app, select the private registry

Updating the Image

Manual Re-pull

When a new version of the image is published with the same tag (e.g., latest), use Save & Re-pull on the app edit screen. PodCubo will:

1. Pull the latest version of the image
2. Stop the current container
3. Start a new container with the updated image

Changing the Tag

To switch to a specific version (e.g., from v1.0 to v2.0):

1. Edit the app and change the image name
2. Click Save & Re-pull

Automatic Volumes

PodCubo automatically detects volumes defined in the Docker image (via VOLUME in the Dockerfile). These volumes are created and mounted automatically, ensuring your data persists across restarts.

You can see detected volumes in the app's Info section.