Docker runtime Projects

This guide will walk you through deploying a Dockerized application on Pandastack.

✅ Prerequisites

  • Your app must expose port 9999, or you must define a custom port using the PORT environment variable.

  • A working Dockerfile at the root of your project, or specify the correct path during setup.

  • A GitHub repository with your Dockerized code.

🛠️ Step-by-Step Deployment

1. Start a New Project

2. Choose Deployment Type

  • Toggle “Run as Container”

3. Fill Project Configuration

Field
Value / Notes

Name

Auto-generated or customize it

Branch

Choose the branch to deploy (e.g., main, master)

Runtime

Select Docker

Region

Choose your deployment region (e.g., US)

Auto Deploy

Leave as Yes (optional toggle)

Base Directory

Path to your app root (default ./)

Environment Vars

Add any needed key-value pairs (like PORT=9999)

4. Select Your Resources

Choose a container plan based on your app’s requirements:

  • Free Tier: 0.25 CPU / 0.5 GB RAM

  • Standard: 1 CPU / 2 GB RAM — $0.0250/hour

  • Memory Series for higher workloads

  • Compute Series for higher workloads

5. Advanced Settings (Optional)

Configure optional settings:

Field
Purpose

Health Check Path

Set to / or another endpoint if you have readiness checks

Dockerfile Path

Typically ./Dockerfile

Build Context

Default ./ unless your Dockerfile is in a subdirectory

Secrets (.env)

Upload secret files if required

PVC Disk

Persistent volume (for apps that require storage)

🚀 Deploy

Click Deploy Container Site → Pandastack will build your Docker image, start the container, and show live streaming logs during deployment.

Once successful, your app will be accessible at the generated subdomain (e.g., https://yourproject.pandastack.app).

🧩 Tips

  • For multi-stage Docker builds, make sure final image exposes only the compiled binary.

  • Always include a HEALTHCHECK or ensure the app is live on / to pass the readiness probe.

  • You can redeploy by pushing to the configured branch (if Auto Deploy is enabled).

PreviousHow to Configure GO projectNextPrivate Connection with database

Last updated