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 production environment, 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 (web for HTTP, worker for background work), with a size and an Instances count.
  • Domain: a hostname pointed at an environment. Every environment has a *.primcloud.app address, 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.