Docs
Quick start
From a GitHub repo to a live HTTPS URL takes three steps from you. Going live is the fourth, and it happens on its own.
- Connect your repo. On Get deployed, paste the GitHub URL and pick the framework.
- Set environment variables. Add the keys your app reads at runtime. You can change them later from the app page.
- Pay. Starter is GHS 100 a month through Paystack, by Mobile Money or card.
- Go live. Your app is queued, built and started. It gets a URL like
my-app.corsacloud.comwith HTTPS.
Every push to the connected branch builds and rolls out a new version after that.
Deploying
Supported apps
Pick Node, Python, Go, Static or Docker when you connect the repo. If your repo has a Dockerfile, choose Docker and we build exactly that.
The port your app listens on
Your app must listen on the port in the PORT environment variable (3000 unless you change it). Requests to your URL are forwarded there.
// Node
const port = process.env.PORT || 3000;
app.listen(port);Zero-downtime rollouts
Each deploy starts the new version next to the old one. Traffic switches only once the new version answers. If the build or start fails, the old version keeps serving and the deploy is marked Failed on the Deployments page.
Logs
Build and runtime logs stream live on each deployment. The latest one is shown at the bottom of the Deployments page.
Environment variables
Variables are set per app and injected when the app starts. Values are masked in the dashboard once saved. Changing a variable takes effect on the next deploy.
Two are set for you:
| Name | What it holds |
|---|---|
PORT | The port your app must listen on. |
DATABASE_URL | The connection string for the app's Postgres database, once one is attached. |
Databases
Each app gets its own isolated Postgres database, not a shared one with a prefix. Your app connects with DATABASE_URL, so there is nothing to copy by hand.
| Starter | Pro | |
|---|---|---|
| Databases | 1 × 5 GB | 2 × 20 GB |
Moving an existing database in
On the Databases page, drop a dump file into Migrate from a dump file. We accept .dump, .backup, .sql and .gz files up to 5 GB. Custom-format dumps restore fastest:
pg_dump --format=custom --no-owner --file=app.dump "$OLD_DATABASE_URL"This works from Neon, Supabase, Render, Heroku or any other Postgres host.
Backups
A backup only counts once it has been restored successfully. Every run does this:
- Dump the database with
pg_dump. - Compress and encrypt it before it leaves the server.
- Upload it off-site to Cloudflare R2, away from the machine your app runs on.
- Restore it into a fresh database to prove it works.
If any step fails, the backup is marked stale on the Databases page and you get an alert.
| Starter | Pro | |
|---|---|---|
| How often | Daily | Twice daily |
| Kept for | 7 days | 30 days |
Restoring
Restoring never overwrites your live database by surprise. It happens in two steps:
- Restore into a copy. On the Databases page, pick a verified backup and choose Restore. It is restored into a separate database and checked.
- Promote it. When you are happy with the copy, choose Review promotion. The copy replaces the live database during a short maintenance window. The old live database is kept until the window closes.
Stop writes from your app before promoting, so nothing written in the meantime is lost.
Domains and HTTPS
Every app gets your-app.corsacloud.com with an HTTPS certificate issued and renewed automatically.
On Pro, you can also point your own domain at the app with one DNS record. The certificate for it is issued as soon as the record resolves.
Plans and limits
| Starter, GHS 100/mo | Pro, GHS 250/mo | |
|---|---|---|
| Apps | 1 | 3 |
| RAM per app | 512 MB | 2 GB |
| Databases | 1 × 5 GB | 2 × 20 GB |
| Backups | Daily, 7 days | Twice daily, 30 days |
| Custom domains | Not included | Included |
| Support | Telegram | Priority, with a person |
Limits are hard stops, not overage charges. If your app reaches its memory limit, it restarts instead of running up a bill. The price on the plan is the price you pay. See current usage on the Usage page.
Monitoring and alerts
We watch CPU, memory, storage and backups for every app. When something crosses a limit or a backup fails, an alert goes to Telegram. Connect it from Integrations.
Billing
Plans are priced in Ghana cedis and billed monthly through Paystack. You can pay with Mobile Money or a card, and a receipt is emailed after each payment.
You can cancel anytime. Your plan stays active until the end of the period you paid for. See your current plan on Billing.
Getting help
Starter support is on Telegram. Pro plans get priority replies from a person. To see what changed recently, check the changelog.