User Documentation

Git init

Sign up for Upsun

Get your free trial by clicking the link below.

Get your Upsun free trial

The basic unit for organizing work within is a project. Each project represents one Git repository, a centralized place to store code and work history. For now, represents the source of truth for your repository. You can later set up an integration with GitHub, Bitbucket, or GitLab.

To deploy your app, you need to connect its repository to a project in

First, create a project by running the following command:

platform project:create

Then go through each of the steps to create the project:

  1. Give it a title.
  2. Choose a region. The CLI lists each region’s location, cloud provider, and average carbon intensity.
  3. Choose a plan. A Development plan is enough before you deploy anything. During a free trial, you can’t choose production plans so you won’t see this option.
  4. Select enough environments. This defaults to 3 environments, which are included in any production-level plan, but you can add more.
  5. Select enough storage. This defaults to 5 GiB, which is included in any production-level plan, but you can add more.
  6. Choose a default branch. This defaults to main, but you can always change it later.

A Git repository is automatically initialized and is set as a remote.

Now your project is initialized and ready for you to make changes.

Is this page helpful?