Deployment

Piora offers multiple flexible deployment methods. Whether your project uses Git version control, pre-built Docker images, or multi-service Docker Compose architectures, you can easily deploy to your VPS.

Deployment Methods Overview

Method	Use Case	Auto Build
Git Deploy	Source code in GitHub/GitLab, need automated CI/CD	Yes (Nixpacks / Buildpacks)
Docker Deploy	Pre-built Docker images or custom Dockerfiles	Optional
Compose Deploy	Multi-container apps with inter-service dependencies	No

Build Tools

Piora includes multiple build tools that can automatically detect your language and framework:

• Nixpacks — Default build tool, supports most languages and frameworks, fast builds
• Buildpacks — Cloud Native Buildpacks, broad compatibility
• Railpack — Optimized for Ruby on Rails and similar frameworks
• Dockerfile — Use your own Dockerfile for full control over the build process

How to Choose

In most cases, the default Nixpacks works well. If your project has special requirements or Nixpacks can’t detect it correctly, switch to Buildpacks or a custom Dockerfile.

Deployment Flow

Regardless of the deployment method, Piora’s deployment flow is roughly:

1. Trigger deployment — Manually or automatically via Git push / Webhook
2. Build image — Generate a Docker image using the selected build tool
3. Health check — Verify the new container starts correctly
4. Traffic switch — Traefik automatically routes traffic to the new container
5. Cleanup — Remove old container versions

Zero-Downtime Deployment

Piora uses a rolling update strategy. The new container must start and pass health checks before the old container is stopped, ensuring no service interruption during deployment.

Environment Variables

All deployment methods support environment variable configuration. You can set environment variables for each application in the Piora dashboard:

DATABASE_URL=postgresql://user:pass@db:5432/mydb
NODE_ENV=production
PORT=3000
SECRET_KEY=your-secret-key

Environment variables are automatically injected into containers at deployment time and stored encrypted in the dashboard.

In This Section

• Git Deploy — Connect Git repositories for automated deployment
• Docker Deploy — Deploy using Docker images
• Compose Deploy — Deploy multi-container apps with Docker Compose