Git Deploy

Git deploy is the most common deployment method. Connect your GitHub or GitLab repository to Piora, and every code push automatically triggers a build and deployment.

Connect a Git Repository

Supported Platforms

• GitHub — Public and private repositories
• GitLab — Public and private repositories (including self-hosted GitLab)

Setup Steps

1. Create a new application in the Piora dashboard
2. Select “Git Repository” as the deployment source
3. Authorize Piora to access your GitHub / GitLab account
4. Choose the repository and branch to deploy
5. Configure build settings (auto-detection works in most cases)

First-Time Authorization

When connecting GitHub, Piora only requests the minimum permissions needed for your selected repositories. You can adjust the authorization scope in GitHub settings at any time.

Build Configuration

Auto-Detection

Piora’s Nixpacks build tool automatically detects most project languages and frameworks:

Language/Framework	Detection
Node.js	package.json
Python	requirements.txt / Pipfile / pyproject.toml
Ruby	Gemfile
Go	go.mod
Rust	Cargo.toml
PHP	composer.json
Java	pom.xml / build.gradle

Custom Build Commands

If auto-detection doesn’t fit your needs, you can manually configure:

# Build command
npm run build

# Start command
npm start

# Install command (optional)
npm ci --production

Using a Dockerfile

If your project root contains a Dockerfile, you can choose to build with it:

FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

FROM node:20-alpine
WORKDIR /app
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
EXPOSE 3000
CMD ["node", "dist/index.js"]

Automatic Deployment

Push Trigger

By default, every git push to the specified branch automatically triggers a deployment:

# Pushing to main branch triggers automatic deployment
git push origin main

Webhook Configuration

Piora automatically sets up a Webhook in your Git repository. If manual setup is needed, the Webhook URL format is:

https://app.piora.dev/api/webhook/git/{app-id}

Branch Filtering

You can configure your application to only listen for push events on specific branches, such as only triggering deployment when pushing to main or production.

Build Logs

Build logs for every deployment are available in the dashboard, including:

• Source code pull progress
• Dependency installation
• Build command output
• Image packaging information
• Deployment status and error messages

Rollback

If you discover issues after deployment, you can quickly roll back to a previous version:

1. Go to the application’s “Deployment History” page
2. Select the version to roll back to
3. Click “Rollback to this version”

Piora retains recent deployment versions, allowing you to roll back at any time.