Getting Started with App Platform

Deploy your web applications with a simple git push or GitHub auto-deploy. Our App Platform supports Node.js, Python, Go, Ruby, PHP, Java, Rust, .NET, Elixir, and any Docker container.

Quick Start

Step 1: Create Your App

1. Log in to your Client Portal
2. Go to Services > PaaS Apps
3. Click New App and choose a name

Your app is created instantly with a unique URL: your-app.apps.colosoft.com

Step 2: Choose Your Deploy Method

Option A — GitHub Auto-Deploy (Recommended):

1. Go to the GitHub tab in your app dashboard
2. Enter your GitHub repository URL
3. Select the branch to deploy (default: main)
4. Enable Auto-Deploy
5. Every push to that branch will auto-deploy your app

Option B — Git Push (SSH Key):

1. Go to the SSH Keys tab
2. Click Add SSH Key and paste your public key
3. Get your key with: cat ~/.ssh/id_ed25519.pub
4. Add the remote: git remote add dokku [email protected]:your-app-name
5. Deploy: git push dokku main

Step 3: Your App is Live!

• Auto-detected language and framework
• Dependencies installed automatically
• SSL certificate provisioned
• App accessible at https://your-app.apps.colosoft.com

What Happens During Deploy

1. Code received — via git push or GitHub webhook
2. Language detected — Node.js, Python, Go, etc. (or Dockerfile)
3. Dependencies installed — npm install, pip install, go mod download, etc.
4. App built — compiled and optimized for production
5. Health check — verifies app responds before routing traffic
6. Zero-downtime switch — traffic moves to new version seamlessly

Supported Languages

Procfile

A Procfile in your project root tells the platform how to start your app:

web: node server.js

web: gunicorn app:app --bind 0.0.0.0:$PORT

Your app must listen on the port specified by the PORT environment variable.

Next Steps

• Set environment variables → Env Vars tab
• Add a custom domain → Domains tab
• Set up GitHub auto-deploy → GitHub tab
• Add your SSH key for git push → SSH Keys tab