---
title: "Deploy a project and environment"
slug: "deploy-a-project-and-environment"
abstract: "How to get started as a developer with SitecoreAI by creating a project and environment in the Deploy app using the starter foundation template."
time: "10 minutes"
---
# Deploy a project and environment



This is part one of the getting started walkthrough series. After you complete this step, move on to [create a site and page](https://doc.sitecore.com/sai/en/developers/sitecoreai/getting-started-with-sitecoreai/create-a-site-and-a-page.html "Create a site and a page").

When you create a new project[^UUID-3ceb7d45-3caf-3196-3a9a-f59a9474182a_xmc_project] in the Deploy app, it automatically creates an environment[^UUID-3ceb7d45-3caf-3196-3a9a-f59a9474182a_xmc_environment] and runs an initial deployment. In this topic, we'll create a project in the Deploy app. You can also create a project using the [Sitecore CLI](https://doc.sitecore.com/sai/en/developers/sitecoreai/sitecore-command-line-interface/create-a-sitecoreai-project-using-the-sitecore-cli.html "Create a SitecoreAI project using the Sitecore CLI") or the [Deploy API](https://doc.sitecore.com/sai/en/developers/sitecoreai/deploying-sitecoreai/deploy-api.html "Deploy API").

> [!note]
> The number of environments you can create is based on your [SitecoreAI](https://doc.sitecore.com/sai/en/users/sitecoreai/sitecoreai.html) subscription.

The steps described here differ, depending on whether you are using Next.js with the Content SDK or the ASP.NET Core SDK.

This walkthrough describes how to:

1. Open the Deploy app
2. Deploy a project and environment

> [!note]
> **Before you begin**
> -   You must [join the Sitecore Cloud Portal organization](https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/en/join-a-sitecore-cloud-portal-organization.html) and have an *Organization Admin* or *Organization Owner* [role](https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/en/roles.html) in the organization where you want to create a project.
>
> -   If you are using the Content SDK, prepare a [GitHub](https://doc.sitecore.com/sai/en/developers/sitecoreai/deploying-sitecoreai/deploy-app/manage-connections-for-source-control-and-hosting-providers.html#UUID-71f2d19c-e26a-47e5-2de2-60f8e5155d4e_section-idm4638634775150433714061582555 "Creating a source control connection with GitHub") or [Azure DevOps](https://doc.sitecore.com/sai/en/developers/sitecoreai/deploying-sitecoreai/deploy-app/manage-connections-for-source-control-and-hosting-providers.html#UUID-71f2d19c-e26a-47e5-2de2-60f8e5155d4e_section-idm1733409789670406 "Creating a source control connection with Azure DevOps") service account and its authentication details.
>
> -   If you are using the ASP.Net Core SDK, open the [ASP.Net starter repository in GitHub](https://github.com/Sitecore/xmcloud-starter-dotnet), log in, click Use this template > Create a new repository, and follow the steps to create your own repo based on the starter kit.

## Open the Deploy app

You start creating your first project in the Deploy app which you can access directly at `https://deploy.sitecorecloud.io/`.

To open the Deploy app in the Cloud Portal:

- On the Sitecore Cloud Portal home page, in the **QUICK LINKS** section, click **SitecoreAI Deploy**.

If you belong to multiple organizations, you might need to [switch to the desired organization](https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/en/switch-your-organization.html).

## Deploy a project with the decoupled deployments architecture (default)

> [!note]
> Projects built before January 2026 were deployed using the legacy coupled deployment architecture. We recommend you to [convert these projects to use the decoupled deployments architecture](https://doc.sitecore.com/sai/en/developers/sitecoreai/deploying-sitecoreai/deploy-app/manage-a-project.html#UUID-8ebad654-053b-e04a-a7a6-6b3780a2a3f5_section-id235230964978301 "Convert a project to Decoupled Deployments architecture").

The Decoupled Deployment feature lets you:

- [Create and manage editing hosts from the Deploy app](https://doc.sitecore.com/sai/en/developers/sitecoreai/environment-editing-hosts-and-rendering-hosts/add-an-editing-host.html "Add an editing host").
- Build and deploy the authoring environment and editing host separately, resulting in faster deployments and independent logging.
- Use the source code from different repositories when adding additional authoring environments and editing hosts to a project.
- Add custom [environment variables](https://doc.sitecore.com/sai/en/developers/sitecoreai/deploying-sitecoreai/deploy-app/manage-an-environment/environment-variables.html "Environment variables") during project or environment creation.

To create a project in the Deploy app using the foundation template with decoupled deployment:

1. In the Deploy app, on the **Projects** page, click **Create project**.

    ![The Create project button in the Deploy app](https://doc.sitecore.com/api/markdown-image/sai/en/developers/sitecoreai/images/deploy_app_create_project-button.png)

2. Name the project *Getting Started*, make sure **Use starter kit** is selected, then click **Continue**.
3. In the **Set up authoring environment** window, name the authoring environment *Getting Started*.
4. Select the source control provider you want to use for your project. Assuming there is no existing connection, click **Add GitHub account** or **Add Azure DevOps account**, and follow the steps to authorize the Deploy app in your account. You can [manage the connection for the source control provider](https://doc.sitecore.com/sai/en/developers/sitecoreai/deploying-sitecoreai/deploy-app/manage-connections-for-source-control-and-hosting-providers.html "Manage connections for source control and hosting providers") later.
5. After authorizing the Deploy app in your source control provider account, enter a name for the repository the Deploy app will create to store your environment code, such as *Getting-Started*.

    > [!note]
    > Your repository name can only contain alphanumeric characters, underscores, periods, or hyphens, and a maximum of 100 characters. It must also follow the repository naming convention of your source control provider.

6. Select the **Auto deploy on push to repository** checkbox and make sure the **Production SaaS SLA** checkbox is clear.

    > [!important]
    > A production environment is optimized for production traffic and is covered by the [Sitecore SaaS Service Level Agreement](https://www.sitecore.com/legal/sla/saas). This setting cannot be changed later.

    At this point, you can add environment variables to your authoring environment, however, it is not needed for this getting started guide, so click **Continue**.

7. In the **Set up editing host** window, select the **Auto deploy on push to repository** checkbox. Since you are using the starter kit, the **Editing host name** is preselected for you.

    Setting up an editing host is optional, but it is needed for this getting started guide.

    > [!note]
    > If you bring your own code and want to set up an editing host:
    >
    > 1.  To select the editing host source code, in the Editing host name field, enter the name of the rendering host defined in the `xmcloud.build.json` file of the editing host code repository.
    >
    > Some code examples, images, and UI labels may still use XM Cloud while engineering assets are being updated.
    >
    > 2.  Choose the source control account and repository that contains the editing host code.
    >
    > For more information, see [manage an editing host](https://doc.sitecore.com/sai/en/developers/sitecoreai/environment-editing-hosts-and-rendering-hosts/add-an-editing-host.html "Add an editing host").

    At this point, you can add environment variables to your editing host, however, it is not needed for this getting started guide, so click **Continue**.

8. Review the configuration and click **Start deployment**.
9. The deployment runs for a few minutes, and you are redirected to the deployment log screen to see the progress (this might take a few seconds). After it completes, you can go to SitecoreAI and create a new site.

> [!tip]
> If your deployment fails, you can [access the deployment log](https://doc.sitecore.com/sai/en/developers/sitecoreai/deploying-sitecoreai/deploy-app/the-deployment-log.html "The deployment log") to investigate what happened and attempt to rerun the deployment.

![The Deploy Settings UI](https://doc.sitecore.com/api/markdown-image/sai/en/developers/sitecoreai/images/2026-02-03_09-18-17.png)

The deployment process:

- Creates a new repository in the connected source control account and copies the source code from the foundation template to the new repository.
- Provisions the infrastructure and SaaS tenants to host the Content Management (CM) instance in the environment you defined.
- Pulls the source code from the repository to a hosted SitecoreAI build server and builds the solution.
- Deploys the build artifacts on the provisioned CM instance.

Now that you've provisioned the project and environment, the environment appears as an app in the [Sitecore Cloud Portal](https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/introduction-to-the-sitecore-cloud-portal.html).

The next thing you'll do is [create a site and page](https://doc.sitecore.com/sai/en/developers/sitecoreai/getting-started-with-sitecoreai/create-a-site-and-a-page.html "Create a site and a page").

## Deploy a project with the legacy coupled deployment architecture

Withe the legacy architecture, when you create a new project[^UUID-3ceb7d45-3caf-3196-3a9a-f59a9474182a_xmc_project] in the Deploy app, it automatically creates an environment[^UUID-3ceb7d45-3caf-3196-3a9a-f59a9474182a_xmc_environment] and runs an initial deployment there. Because the Decoupled Deployments architecture is the default deployment, follow these instructions to enable the legacy coupled deployment architecture:

1. Go to **Settings**.
2. Disabled the **Use the Decoupled Deployments** toggle.

![The Deploy Settings UI](https://doc.sitecore.com/api/markdown-image/sai/en/developers/sitecoreai/images/2026-02-03_09-18-17.png)

### Content SDK (Next.js)

If you are creating a Content SDK app, in this walkthrough, you create a project using the Content SDK starter kit in a ready-made flow in the Deploy app.

To deploy a Content SDK project in the Deploy app:

1. In the Deploy app, on the **Projects** page, click **Create project**.

    ![The Create project button in the Deploy app](https://doc.sitecore.com/api/markdown-image/sai/en/developers/sitecoreai/images/deploy_app_create_project-button.png)

2. Name the project, for example, *Getting Started*, then click **Continue**.
3. To choose the source control provider you want to use for your project click **Connect**, then **Continue**. The Deploy app will create a new repository there to store your environment code.
4. In the **Set up repository** step, make sure **Use XM Cloud template** is selected.

    > [!note]
    > **XM Cloud is now SitecoreAI**
    > Some code examples, images, and UI labels may still use XM Cloud while engineering assets are being updated.

5. Assuming there is no existing connection, click **Connect to a new account**, and follow the steps to authorize the Deploy app in your account. You can later [manage the connection for the source control provider](https://doc.sitecore.com/sai/en/developers/sitecoreai/deploying-sitecoreai/deploy-app/manage-connections-for-source-control-and-hosting-providers.html "Manage connections for source control and hosting providers").
6. Enter a name for the repository, such as *Getting-Started*, then click **Continue**.

    > [!note]
    > Your repository name can only contain alphanumeric characters, underscores, periods, or hyphens, and a maximum of 100 characters. It must also follow the repository naming convention of your source control provider.

7. Name the environment, for example, *Getting Started*.
8. In the **Production SaaS SLA** field, select **No**.

    > [!important]
    > A production environment is optimized for production traffic and is covered by the [Sitecore SaaS Service Level Agreement](https://www.sitecore.com/legal/sla/saas). This setting cannot be changed later.

9. In the **Auto deploy on push to repository** field, select **Yes**.
10. Review the configuration and click **Start deployment**.
11. The deployment runs for a few minutes, and you are redirected to the deployment log screen to see the progress (this might take a few seconds). After it completes, you can go to SitecoreAI and create a new site. The deployment creates a new repository in the connected source control account and copies the source code from the foundation template to the new repository.

### ASP.NET Core SDK

If you are creating a ASP.NET Core app, in this walkthrough, you create a project using the .NET Core starter kit[^UUID-3ceb7d45-3caf-3196-3a9a-f59a9474182a_xmc_aspnetcore-startertemplate] in a bring-your-own code flow in the Deploy app.

To deploy a .NET Core project in the Deploy app:

1. In the Deploy app, on the **Projects** page, click **Create project**.

    ![The Create project button in the Deploy app](https://doc.sitecore.com/api/markdown-image/sai/en/developers/sitecoreai/images/deploy_app_create_project-button.png)

    > [!note]
    > **XM Cloud is now SitecoreAI**
    > Some code examples, images, and UI labels may still use XM Cloud while engineering assets are being updated.

2. Name the project, for example, *Getting Started*, then click **Continue**.
3. To choose the source control provider you want to use for your project click **Connect**, then **Continue**. The Deploy app will create a new repository there to store your environment code.
4. In the **Set up repository** window, click **Use your own code**.
5. Assuming there is no existing connection, click **Connect to a new account**, and follow the steps to authorize the Deploy app in your account. You can later [manage the connection for the source control provider](https://doc.sitecore.com/sai/en/developers/sitecoreai/deploying-sitecoreai/deploy-app/manage-connections-for-source-control-and-hosting-providers.html "Manage connections for source control and hosting providers").
6. Choose the GitHub account and repository to which you cloned the .Net Core starter kit (the default branch should be auto-selected), then click **Continue**.

    > [!note]
    > Your repository name can only contain alphanumeric characters, underscores, periods, or hyphens, and a maximum of 100 characters. It must also follow the repository naming convention of your source control provider.

7. Name the authoring environment *Getting Started*.
8. In the **Production SaaS SLA** field, select **No**.

    > [!important]
    > A production environment is optimized for production traffic and is covered by the [Sitecore SaaS Service Level Agreement](https://www.sitecore.com/legal/sla/saas). This setting cannot be changed later.

9. In the **Auto deploy on push to repository** field, select **Yes**.
10. Review the configuration and click **Start deployment**.
11. The deployment runs for a few minutes, and you are redirected to the deployment log screen to see the progress (this might take a few seconds). After it completes, you can go to SitecoreAI and create a new site.

> [!tip]
> If your deployment fails, you can [access the deployment log](https://doc.sitecore.com/sai/en/developers/sitecoreai/deploying-sitecoreai/deploy-app/the-deployment-log.html "The deployment log") to investigate what happened and attempt to rerun the deployment.

The deployment process:

- Creates a new repository in the connected source control account.
- Provisions the infrastructure and SaaS tenants to host the Content Management (CM) instance in the environment you defined.
- Pulls the source code from the repository to a hosted SitecoreAI build server and builds the solution.
- Deploys the build artifacts on the provisioned CM instance.

Now that you've provisioned the project and environment, the environment appears as an app in the [Sitecore Cloud Portal](https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/introduction-to-the-sitecore-cloud-portal.html).

The next thing you'll do is [create a site and page](https://doc.sitecore.com/sai/en/developers/sitecoreai/getting-started-with-sitecoreai/create-a-site-and-a-page.html "Create a site and a page").

[^UUID-3ceb7d45-3caf-3196-3a9a-f59a9474182a_xmc_project]: A **project** is a logical grouping of environments. Each project can include several environments, such as a development, testing, and production environment. In SitecoreAI, you can create a project using the Deploy app, the CLI, or REST APIs.
    
    When you create a project using the Deploy app, one environment is automatically created, and you can choose whether it’s a production environment (that gets faster support than the non-production environments). The number of projects you can create depends on your subscription.

[^UUID-3ceb7d45-3caf-3196-3a9a-f59a9474182a_xmc_environment]: An *environment* is an entity that holds a set of configurations, code, and implementations. Each environment includes the following:
    
    - A single content management (CM) instance
    - [Experience edge tenant](https://doc.sitecore.com/sai/en/developers/sitecoreai/experience-edge.html)
    - Databases
    - Indexes
    - Automation clients
    - Environment variables
    - Rendering hosts
    - An app tenant that connects the CM instance with functionality such as Page builder
    
    Each environment is isolated and unique. This allows you to have unique customizations, deployments, and configurations on your environment, based on implementation needs.

[^UUID-3ceb7d45-3caf-3196-3a9a-f59a9474182a_xmc_aspnetcore-startertemplate]: The *starter kit* is a code base that’s intended to be the basis of most implementations for ASP.NET Core applications. To use it, follow the use your own code flow when [getting started with SitecoreAI](https://doc.sitecore.com/sai/en/developers/sitecoreai/getting-started-with-sitecoreai.html "Getting started with SitecoreAI"). It is open source, and available on GitHub. Using the starter kit ensures you get the most stable and up-to-date version of the assets, references, assemblies, and artifacts we recommend using when you start building a solution with SitecoreAI.