Working with a Local Clone of an Umbraco Cloud Site
Cloning the Umbraco Project
From the Umbraco Cloud portal, copy your development environments git repository endpoint using the How to connect my machine option and then clone the site using your favorite Git client. We like Fork, SourceTree, Git Extensions, or GitKraken.
Here are the steps to clone your site (We'll use Fork in this example.):
Click the Connect my machine button to get the Clone project dialog.
Copy the Clone Url from the portal for your dev environment.
From Fork, select Clone.
Set your destination path to where you keep your local work.
Paste the URL in to the URL box.
Choose a name for the local project folder (preferably using the project name).
Click Clone the repo!
You’ll be prompted to log in - Use the same credentials as you use for Umbraco Cloud.
Now, you have an exact copy of your Umbraco Cloud environment that you can run locally. For information on how to run the site locally, see the Running the Site Locally section or the
Readme file in the project.
We like to use Visual Studio Code when working locally, but you can use Visual Studio or any other development tool or web server. When you run your local site for the first time, you’ll be prompted to restore your site's content. Wait until this process completes as it also creates the local SqlCE database for your site.
That's it! Now you can work with your site locally as you would with any other Umbraco site. You can create content, add media, even create your own custom code. When you're ready to deploy your changes make sure to have a look at the deployments documentation.
If you have more than "a few" media items see our recommendations for working with media in Umbraco Cloud.
Running the Site Locally
To run Umbraco 9 locally, you will need to install the .NET 5.0 SDK (if you do not have this already).
With .NET 5 installed, run the following commands in a terminal application of your choice:
Navigate to the newly created project folder:
Build and run the new Umbraco .Net Core project:
dotnet build dotnet run
The terminal output will show the application starting up and will include localhost URLs which you can use to browse to your local Umbraco site.
The first time the project is run locally, you will see the restore boot-up screen from Umbraco Cloud. If the environment you have cloned already contains Umbraco Deploy metadata files (such as Document Types), these will automatically be extracted with the option to restore content from the Cloud environment into the local installation.
When running locally, it is recommend to setup a developer certificate and run the website under HTTPS. If you haven't configured one already, then run the following dotnet command:
dotnet dev-certs https --trust