> ## Documentation Index
> Fetch the complete documentation index at: https://developer.upsun.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a project

> All you need to know about creating a new project with Upsun Cloud

To create a new project on Upsun Cloud, you can take one of two paths:

> [accordion] Using the Console (recommended)
>
> Open the [Upsun Cloud management Console](https://console.upsun.com/-/create-project) to create your project.
>
> > [!NOTE]
> >
> > If you haven't done so already, you are prompted to create your first organization where your project will reside.
>
> ![Create project options](https://mintcdn.com/upsun-c9761871/7cK3KMJBgO7MXm_y/images/console/create-project.png?fit=max\&auto=format\&n=7cK3KMJBgO7MXm_y\&q=85\&s=5e9f2a961605941b9850261215cd686b)
>
> From the Console, what you do next entirely depends on where the "source of truth" of your codebase is located.
> In this guide, you will push your local repository to Upsun Cloud.
> That is, the only copy of your codebase you'd like to deploy is on your local computer.
>
> Click **Start from scratch** from the **Deploy with Git** option.
>
> > [!NOTE]
> >
> > Git integrations
> > This guide does not specifically address integrating an Upsun Cloud project with a third party repository such as one on GitHub, even though the **Connect repository** option is available at this stage.
> >
> > For now, continue to work locally.
> > Third party integrations will be addressed at the end of this guide.
>
> Add details about your project, such as:
>
> * The name of your project.
> * The default branch of your local repository.
> * Select the region where you want your project to be hosted.
>
> As suggested in the Console, connect the local copy of your repository to your project:
>
> ```bash theme={null}
> upsun project:set-remote <PROJECT_ID>
> ```
>
> Your local source code is automatically linked to your newly created Upsun Cloud project through the creation of a `.upsun/local/project.yaml` file.  This file contains the corresponding `<projectId>` and sets a Git remote to `upsun`.

> [accordion] Using the CLI
>
> To create a new project with the Upsun Cloud CLI, use the following command and follow the prompts:
>
> ```bash Terminal theme={null}
> upsun project:create
> ```
>
> > [!NOTE]
> >
> > Default branches
> > When creating a new project using the Upsun Cloud 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 Cloud 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 Cloud.
> That is, the only copy of your codebase you'd like to deploy is on your local computer.
>
> > [!NOTE]
> >
> > Git integrations
> > This guide does not specifically address integrating an Upsun Cloud 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 Cloud project.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.