Help us improve the documentation area
We'd love to make the documentation for Umbraco even better, but we need your help on where we should focus the most. So please help us help you by spending a few minutes taking this short survey.Take the Survey (and this box will also go away)
Working with a local clone of an Umbraco Cloud site
To work with a local copy of your site you'll need to use Windows and have a local web server installed (like WebMatrix / IIS). If you're not using Windows you can still work with your site's files (Templates, Css, JS, etc...) but you'll need to deploy these to your development site before you can "see" your updates - head over to our chapter on Working with UaaS Cli for more documentation on this.
If you are using Windows, read on for how to work locally.
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 GitKraken, SourceTree or Git Extensions. Here are the steps to clone your site (We'll use GitKraken 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 GitKraken select Clone Repo
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 locally.
We like to use Microsoft WebMatrix or Visual Studio Code when working locally, but you can use Visual Studio or another development tool or web server of course. 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 just as 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.
Note: If you have more than "a few" media items see our recommendations for working with media in Umbraco Cloud.