# Project Settings

When working with an Umbraco Cloud project, you can handle the project configuration directly in the Umbraco Cloud Portal. You can manage the following configurations from the left-side menu:

![Settings menu](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-70f32ef03fc7477efed157d2d296a02fa8703334%2Fsettings-menu.png?alt=media)

## Overview

### Environments

The Environments section provides an overview of your project’s environments. Here, you can:

* Access the Website (frontend) and backend,
* Open Kudu, and
* Clone down the environment locally.

![Environments Overview](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-5a15262baedf54c32ffb049af032385fa036e1d0%2Fenvironments-overview-new.png?alt=media)

### Team

The Team section allows you to:

* Manage team members and their permissions on different environments.
* Add new team members.
* Manage backoffice user groups and [Technical contacts](https://docs.umbraco.com/umbraco-cloud/begin-your-cloud-journey/project-features/team-members/technical-contact) for your project.
* Monitor pending project invitations.

<figure><img src="https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-22718cf478be7ed509b5e5fffa3988e18dde2318%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Summary

The **Summary** section displays key information such as the project plan, the region where the project was created, payment status, and more.

![Project Summary](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-2c8dc93a21486bb97932575405f6166de8bb7f62%2Fsummary-details.png?alt=media)

## Insights

### [Project History](https://docs.umbraco.com/umbraco-cloud/optimize-and-maintain-your-site/monitor-and-troubleshoot/project-history)

In the Project History section, you can view a list of high-level activities for your cloud project.

![Project History](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-50dda6ab1fdb27f623bffd17f2e757275e1df3b5%2Fproject-history.png?alt=media)

### [Hostname Monitoring](https://docs.umbraco.com/umbraco-cloud/optimize-and-maintain-your-site/monitor-and-troubleshoot/hostname-monitoring)

Hostname monitoring allows you to track the availability and response times of your websites. You can configure monitors for multiple hostnames, set check frequency and locations, and view historical ping results. This helps ensure optimal website performance and alerts you to potential downtime or performance issues.

### [Availability & Performance](https://docs.umbraco.com/umbraco-cloud/optimize-and-maintain-your-site/monitor-and-troubleshoot/availability-performance)

You can see metrics related to the overall health and performance of the Azure app service hosting the different environments of your solution.

![Availability & Performance](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-eeef035f6cc93bedb2f4f804b3b7befec796022a%2Favailability-performance.png?alt=media)

### [Usage](https://docs.umbraco.com/umbraco-cloud/optimize-and-maintain-your-site/monitor-and-troubleshoot/usage)

The Usage section allows you to:

* View the usage of Custom Domains, Media Storage, Bandwidth, and Bandwidth History for your project.
* Check whether the project is using above or below the allowed amount for its plan.
* View the top 10 bandwidth usage paths, referrers, and the top 50 media files.

![Usage](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-32b73c0e1d1f28b7e357d074993fcf7c84b20560%2Fusage-new.png?alt=media)

### Environment Logs

Each environment has an error log that appears only if there are any unread errors in that specific environment. You can view the errors by clicking on **Environment logs** in the **Insights** menu.

During development, too many errors can slow down the error page. To fix this, connect to the environment's database locally and delete the errors. Learn how to connect to the database in the [Database on Umbraco Cloud](https://docs.umbraco.com/umbraco-cloud/build-and-customize-your-solution/set-up-your-project/databases/cloud-database) section.

Environment errors are stored in the `UCErrorLog` table.

The query below deletes 90% of the errors. The query always deletes the oldest errors first. You can tweak the query to delete any percentage of errors by changing the number in the first row.

```sql
DELETE TOP(90) PERCENT
  FROM [dbo].[UCErrorLog]
  WHERE [Read] = 0
```

## Configuration

### [Connections](https://docs.umbraco.com/umbraco-cloud/build-and-customize-your-solution/set-up-your-project/databases)

The Connections section provides connection details for your Umbraco Cloud databases. You need to allow your IP to connect to the databases with your local machine.

![Connections](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-69f4f80c3360f1c2d2698f72143658a91ee09fb3%2Fconnections.png?alt=media)

### [Automatic Upgrades](https://docs.umbraco.com/umbraco-cloud/optimize-and-maintain-your-site/manage-product-upgrades/product-upgrades/minor-upgrades)

The Automatic Upgrades section handles minor and patch upgrades for the Umbraco components used by Umbraco Cloud. By default, new projects have automatic upgrades enabled.

You can manage whether your site is automatically upgraded with the latest patch and minor version(s) of Umbraco CMS, Forms, and Deploy.

For information about opting out of automated upgrades, see the [Product Upgrades](https://docs.umbraco.com/umbraco-cloud/optimize-and-maintain-your-site/manage-product-upgrades/product-upgrades) article.

![Automatic Upgrades](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-e0080b3c2298696aeca92eab90a9c07cb27189ae%2Fautomatic-upgrades.png?alt=media)

### [Content Delivery Network (CDN) and Caching](https://docs.umbraco.com/umbraco-cloud/optimize-and-maintain-your-site/optimize-performance/manage-cdn-caching)

The CDN and Caching section lets you manage CDN Caching and Optimization settings for your project. You can:

* Modify the default settings that apply to all hostnames added to the project.
* Set specific caching settings per hostname if different configurations are required for certain hostnames.
* Purge Cache for individual hostnames or all of them.

![CDN & Caching](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-2fb2eb31e055bd746eb955237a69d8a22e9d3f07%2Fcdn-caching.png?alt=media)

### [Hostnames](https://docs.umbraco.com/umbraco-cloud/go-live/manage-hostnames)

In the Hostnames section, you can bind hostnames to your Umbraco Cloud project.

![Hostnames](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-5083411c061074a26ef35a1ba86a235578a330d3%2Fhostnames.png?alt=media)

### [Webhooks](https://docs.umbraco.com/umbraco-cloud/build-and-customize-your-solution/handle-deployments-and-environments/deployment/deployment-webhook)

You can configure deployment webhooks for your environments in this section. Webhooks are triggered upon successful deployments, and you can specify where the deployment information is sent.

![Webhooks](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-329d58666ec6afe4f881d5911fa8abfbceb14930%2Fwebhooks.png?alt=media)

### [CI/CD Flow](https://docs.umbraco.com/umbraco-cloud/build-and-customize-your-solution/handle-deployments-and-environments/umbraco-cicd)

The CI/CD Flow section allows you to manage settings related to CI/CD deployments:

* Enable CI/CD Flow with or without Advanced options.
* See a list of environments that can be targeted by CI/CD Flow.
* See a paginated list of artifacts that have been pushed to your project via the CI/CD pipeline.

![CI/CD Flow settings](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-9fb115ca76e1d748f8a356ed142d6114636f4065%2Fcicd-flow-page.png?alt=media) ![CI/CD Flow Artifact list](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-0c53db79b59300c0c96fcc8ff3372d5846e5529f%2Fcicd-artifacts.png?alt=media)

### Advanced

The Advanced section provides options for managing advanced settings for your project, including:

* [Enable static outbound IP addresses](https://docs.umbraco.com/umbraco-cloud/expand-your-projects-capabilities/external-services#enabling-static-outbound-ip-addresses) for projects on **Standard**, **Professional**, or **Enterprise** plans.
* Enable IIS logging for each environment. The log files can be accessed in Kudu at `C:\home\LogFiles\http`. IIS logs have a rolling size limit of 100 MB, overwriting the oldest files once the limit is reached.
* [Enable loading of a client certificate from the file system](https://docs.umbraco.com/umbraco-cloud/build-and-customize-your-solution/set-up-your-project/application-settings#enable-client-certificate-loaded-from-file-system-explained).
* Change the .NET framework runtime for each environment of your Umbraco Cloud project.
* Change the value of the `DOTNET_ENVIRONMENT` environment variable for each environment of your Umbraco Cloud project. To learn more about working with multiple environments in ASP.NET Core, refer to the [Microsoft Documentation](https://learn.microsoft.com/en-us/aspnet/core/fundamentals/environments?view=aspnetcore-9.0).
* [Manage Platform Configuration](https://docs.umbraco.com/umbraco-cloud/build-and-customize-your-solution/set-up-your-project/project-settings/platform-configuration) to control Proactive Auto-Heal and Always On for your environments. Managing these settings is available only for environments on a **Dedicated** plan.

{% hint style="info" %}
Enabling IIS logging will cause the site to restart. For additional information, refer to the [Microsoft Documentation](https://docs.microsoft.com/en-us/iis/configuration/system.webserver/httplogging).
{% endhint %}

{% hint style="info" %}
Changing the .NET framework runtime or the `DOTNET_ENVIRONMENT` environment variable will also cause your website to restart.
{% endhint %}

{% hint style="info" %}
When using `WebApplication`, `DOTNET_ENVIRONMENT` takes precedence over `ASPNETCORE_ENVIRONMENT`. When using the legacy `WebHost`, `ASPNETCORE_ENVIRONMENT` takes precedence instead.

You can also override the environment value by setting the `ASPNETCORE_ENVIRONMENT` variable in your `web.config` file.
{% endhint %}

![Advanced Settings](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-bce889947f53d021f5fcc8b3e666932d8b4fbed2%2Fadvanced-settings.png?alt=media)

![Advanced Settings continued](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-f94f99fad49bccd4958de4833e36627f5b09e0c3%2Fadvanced-settings-continued.png?alt=media)

### [Backups](https://docs.umbraco.com/umbraco-cloud/build-and-customize-your-solution/databases/backups#backup-on-umbraco-cloud)

The Backups section enables you to create database backups for one or more of your cloud environments.

![Backups](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-8946d3f8787cd87176ad6b91be8fab7dd4482494%2Fbackups.png?alt=media)

## Security

### [Public Access](https://docs.umbraco.com/umbraco-cloud/build-and-customize-your-solution/set-up-your-project/project-settings/public-access)

{% hint style="info" %}
By default, Public access is available for projects created after the 10th of January 2023.

The [Umbraco.Cloud.Cms.PublicAccess](https://www.nuget.org/packages/Umbraco.Cloud.Cms.PublicAccess) package can be installed to enable Public access for projects created before the 10th of January 2023.
{% endhint %}

The Public access setting, found under the Security tab, allows you to deny access to your project. Users who are not part of the project or whose IP addresses have not been allowed will not be able to access the project.

You can enable or disable this setting on the Public access page. Access to manage Public access requires your project to be on the Standard plan or higher.

![Public Access](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-87c572c18edd3e7fdb0a28c0153f2f29d92385c9%2Fpublic-access.png?alt=media)

### [External Login Providers](https://docs.umbraco.com/umbraco-cloud/begin-your-cloud-journey/project-features/external-login-providers)

External Login Providers allow you to integrate third-party authentication systems to manage backoffice user logins securely. Using OpenID Connect, you can connect providers like Microsoft Entra ID, Auth0, and Google to simplify login management and improve security for your teams.

### [Transport Security](https://docs.umbraco.com/umbraco-cloud/build-and-customize-your-solution/set-up-your-project/security/managing-transport-security)

The Transport Security section enables you to manage transport security settings for your project. You can configure specific transport security options for all hostnames or individual hostnames within your project.

![Transport Security](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-13e606fe9c563ded5d37b4196e71a20a8326ee5a%2Ftransport-security.png?alt=media)

### [Management API Security](https://docs.umbraco.com/umbraco-cloud/optimize-and-maintain-your-site/monitor-and-troubleshoot/management-api-security)

The Management API Security section allows you to secure access to the backend services of your project. This can be managed from the Security menu on the Umbraco Cloud Portal.

![Management API Security](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-795ac0c5f47f1288530b6f6da2a548ef6923d047%2Fmanagement-api-security.png?alt=media)

### [Secrets](https://docs.umbraco.com/umbraco-cloud/begin-your-cloud-journey/project-features/secrets-management)

The Secrets Management section is used for storing sensitive information such as API keys, encryption keys, and connection strings used by your Umbraco Cloud project.

![Secrets](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-c3c79f3d0d04843e21368e78af03a645844b2b4f%2Fsecrets.png?alt=media)

## Management

### [Baselines](https://docs.umbraco.com/umbraco-cloud/begin-your-cloud-journey/creating-a-cloud-project/baselines)

A Baseline is a project that serves as a template for creating child projects. When you set up a baseline project, you can quickly spin up new projects with the same packages, components, and configuration. Any changes you make to the baseline can be pushed to all connected child projects, keeping them in sync.

![Baselines](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-f476a041c2b6672b65922b7ebabc60e116e49279%2Fmanage-child-projects.png?alt=media)

### [Dedicated Resources](https://docs.umbraco.com/umbraco-cloud/build-and-customize-your-solution/set-up-your-project/project-settings/dedicated-resources)

You can change your Umbraco Cloud project to run in a dedicated setup with additional computational resources compared to the shared setup. You can choose between different dedicated options depending on the number of resources you will need for your project.

![Dedicated Resources](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-c9f13316d1f3f31b0a0321933911084d4479f04e%2Fdedicated-resources.png?alt=media)

### Change Plan

You can change your Umbraco Cloud plan to upgrade to a higher plan or downgrade to a lower plan depending on your project needs. You can manage plan changes and dedicated resources from the **Management** menu.

![Change Plan](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-2bf5c2bf602aac470903c86b98523c84b4803474%2Fchange-plan.png?alt=media)

### Rename Project

You can rename your Umbraco Cloud project from the **Management** menu.

{% hint style="info" %}
If you are working locally, you need to update the origin of your local git repository to point to the new clone URL. Alternatively, you can make a fresh local clone of the project once you’ve changed your project name.
{% endhint %}

![Rename Project](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-2b2714fcf162251a26dbd9c6e8ac3545f12cf920%2Frename-project.png?alt=media)

#### [Renaming the Project file and folder](https://docs.umbraco.com/umbraco-cloud/handle-deployments-and-environments/working-locally#renaming-the-project-files-and-folders)

You can rename your project from the **Rename Project** section in the **Management** menu on the Umbraco Cloud Portal. When you rename a project, the default hostnames and clone URLs assigned to the project are updated to match the new project name. You can also rename your project files and folders locally.

### Delete Project

You can delete your Umbraco Cloud project from the **Management** menu. Deleting your Umbraco Cloud project is permanent - all data, media, databases, configuration, setup, and domain bindings are removed in the process.

{% hint style="info" %}
Deleting your Umbraco Cloud project will also cancel any subscriptions you have set up for the project.
{% endhint %}

![Delete Project](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-42b45fe1a20ec6869157f92743ab699fca070ed7%2Fdelete-project.png?alt=media)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.umbraco.com/umbraco-cloud/build-and-customize-your-solution/set-up-your-project/project-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
