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

• Go to dashboard.pandastack.io/projects

• Click “Add 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).