Skip to main content
To create a new project on Upsun, you can take one of two paths:
To create a new project with the Upsun CLI, use the following command and follow the prompts:
Terminal
upsun project:create

Default branches

When creating a new project using the Upsun CLI command project:create, the default production branch is set to main. Change it if your default branch is different (e.g.: master).
Then, you are asked if you want to set the local remote to your new project. Enter Yes (y).Your local source code is automatically linked to your newly created Upsun project through the creation of a .upsun/local/project.yaml file. This file contains the corresponding <projectId> and sets a Git remote to upsun.In this guide, you will push your local repository to Upsun. That is, the only copy of your codebase you’d like to deploy is on your local computer.

Git integrations

This guide does not specifically address integrating an Upsun project with a third party repository such as one on GitHub, even though you will notice the Connect repository option available at this stage.
For now, continue to work locally. Third party integrations will be addressed at the end of this guide.
So long as you chose y (yes) to the question Set the new project <projectName> as the remote for this repository? during the project:create command, your local project is already integrated to the Upsun project.
Last modified on March 10, 2026