Docs menu

Quickstart

Connect a git repo, deploy an app, and reach it at a *.primcloud.app URL in about five minutes.

On this page

Connect a git repo, deploy an app, and reach it at a *.primcloud.app URL. It takes about five minutes.

Before you start#

You'll need:

  • A Primcloud account. Sign up at primcloud.com. Standard accounts have no monthly fee; compute is metered by the minute once you deploy, from around $5/mo for the smallest app.
  • A GitHub account with a repo you can deploy.
  • A buildable repo. If you don't have one handy, fork a Heroku sample repo in your language. They build on Primcloud with no changes.

1. Connect GitHub#

From the dashboard, click Connect GitHub and install the Primcloud GitHub App on the repos you want to deploy, either specific repos or your whole account. GitHub then asks you to authorize Primcloud, which lets us confirm the installation is yours.

The connection appears under Providers in your account settings, and every repo it can see shows up when you create an app. Source Control covers the details.

2. Create an application#

Hit Import Git Repository on the applications list. The import has three steps:

  1. Select a repository.
  2. Configure the branch to deploy and the region to run in. Every push to that branch deploys.
  3. Verify the commit you're about to deploy, then hit Import.

The first deployment starts right away.

3. Watch the first deployment#

You land on the deployment page, where the build log streams live. The deployment goes through these phases:

  • Build: Primcloud detects your app's language, installs its dependencies, and builds it.
  • Release: runs your release command, if your Procfile declares one. Otherwise it's skipped.
  • Rollout: the new version starts and takes over traffic.
A deployment's streaming build log, showing the build detecting, installing, and building the app

When the Rollout phase shows Complete, your app is live. Compute is metered from then on; see Plans for pricing.

4. Reach your app#

Every environment gets a *.primcloud.app URL, shown in the dashboard header. Click it to open your app.

The application overview header showing the app name, its *.primcloud.app URL, repository and branch, region, and last deployment

Where to go next#