Docs menu
Introduction
Primcloud is a platform-as-a-service that builds, deploys, and runs your app from a git repo. This is the reference for how it works.
On this page
Primcloud is a platform-as-a-service: hand it your git repo and it builds your app, deploys it, and keeps it running. These docs cover how it works, from your first deploy to billing.
The model#
Five concepts show up on almost every page.
- Application: a project on Primcloud. Backed by a git repo, owns its environments (one,
production, on Standard; more per application on Pro and Team). - Environment: a deployment target inside an application. Every application starts with a
productionenvironment, which owns its own branch, configuration, domains, and running processes. - Deployment: a specific build of your application released to an environment. You can roll back to an earlier one.
- Formation: a process type your app runs (
webfor HTTP,workerfor background work), with a size and an Instances count. - Domain: a hostname pointed at an environment. Every environment has a
*.primcloud.appaddress, plus any custom domains you add.
Configuration (secrets, compute sizing, formations) is scoped to environments.
Where to go next#
- New here? The Quickstart deploys an app in a few minutes.
- Learning the concepts? Read the Basics section in order, starting with Source Control.
- Deploying a specific language? See Language Support.
- Moving from another host? Follow a guide in How-to.
- Billing questions? See Billing.