umbracocloud 17.8.0

Umbraco Cloud Local Setup Template

This dotnet new template automates the initial local setup of an Umbraco Cloud project. When you create a new Umbraco Cloud project on version 9 or above, the git repository uses a generic default project name (UmbracoProject) and requires several manual steps before it is ready for development. This template handles all of that automatically via an interactive wizard.

Prerequisites

You need an Umbraco Cloud project before using this tool.

• New to Umbraco Cloud? Watch an introduction video or sign up for a free trial.
• Once your project is created, grab the git clone URL from the Umbraco Cloud portal.

Getting started

1. Install the template:

   dotnet new install umbracocloud
   

2. Run the template with your Cloud git URL:

   dotnet new umbracocloud --git <your-umbracocloud-git-url.git>
   

3. Follow the wizard in the terminal — it will walk you through the options below.

Each developer on the team needs their own local database. SQLite is used by default.

Remember to push your changes back via git — changes are not stored in the Cloud until they are pushed.

What the wizard sets up

Project renaming Renames the default UmbracoProject folder and .csproj file to your chosen namespace (e.g. MyCompany.Web), and updates the .umbraco metadata file so Umbraco Cloud recognises the new structure.

Environment configuration Creates a Local environment alongside the existing Development and Production environments, and configures appsettings for each:

• ModelsBuilder set to SourceCodeAuto locally, Nothing in common settings
• CMS Runtime mode set per environment (Development locally, Production in common)
• Default language set to en-US
• UmbracoApplicationUrl set to your production hostname

Output caching Optionally enables Website Output Caching in appsettings.json. Note: load-balanced setups require Redis for output caching.

Delivery API Optionally enables the Umbraco Delivery API.

IIS / web.config Generates a web.config with a redirect rule from *.azurewebsites.net to your production domain, and a web.Production.config XDT transform that redirects from *.umbraco.io to your production domain.

Backoffice IP restriction Optionally restricts access to the Umbraco backoffice (/umbraco) on Production to your IP address only, while keeping Umbraco Deploy endpoints accessible.

Subscriber Dockerfile Optionally generates a Dockerfile for Legacy Load Balancing Subscriber instances.

Solution file Creates either a .slnx (new XML format, requires VS 17+ or .NET SDK 9.0.200+) or classic .sln solution file, and optionally adds a class library project (e.g. MyCompany.Core) to the solution.

Prefer to set up manually?

git clone <your-umbracocloud-git-url.git>

Then follow the ReadMe.md included in your cloned repository.