Deploy Lifecycle

↓ Download .md

Deploy Lifecycle

Understand how PodCubo manages your deploy lifecycle.

App Status

Each app has a status indicating its current state:

Status Description
Running App running normally
Stopped App stopped (manually or due to failure)
Deploying Deploy in progress
Building Image build in progress (Git apps)

Deploy Flow — Git App

When you push to GitHub or click Save & Rebuild:

  1. Connecting to GitHub — PodCubo accesses your repository
  2. Building image — Builds the Docker image from the Dockerfile
  3. Transferring image — Transfers the image to the server (if needed)
  4. Creating container — Creates the container with the new image
  5. Starting service — Starts the service via systemd

Deploy Flow — Docker Image

When you create an image app or click Save & Re-pull:

  1. Pulling image — Downloads the image from the registry
  2. Creating container — Creates the container
  3. Starting service — Starts the service

Deploy Flow — Database

  1. Creating volumes — Creates volumes for persistence
  2. Pulling image — Downloads the database image
  3. Creating container — Creates the container with mounted volumes
  4. Starting service — Starts the service

Available Actions

Save & Restart

Restarts the app with current settings. Uses the same image — ideal when you've changed environment variables or port.

Save & Rebuild (Git Apps)

Clones the repository again, rebuilds the image, and deploys. Use when you need to force a rebuild without pushing.

Save & Re-pull (Image Apps)

Pulls the latest version of the image and restarts. Use when a new version has been published with the same tag.

Auto-recovery

PodCubo uses systemd to manage your containers. This means:

  • If your app crashes, systemd restarts it automatically in seconds
  • If the server restarts, all apps come back automatically
  • There's no "cold start" — your apps are always ready

AI Error Diagnosis

When a build fails or your app encounters errors, PodCubo automatically analyzes them with AI and suggests fixes. You can see the diagnosis on the app edit screen.

Logs

Access your application logs in real-time in the Logs tab on the edit screen. Logs show both standard output (stdout) and errors (stderr) from your container.