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)
Welcome to Umbraco Cloud
We're excited you have decided to use Umbraco Cloud!
What's up with the name Umbraco Cloud?
Since Umbraco Cloud is Umbraco in a cloud environment we thought we'd stick with a name that describes what it is. So there you go.
Projects and Environments
In Umbraco Cloud we organize your work into projects which are made of environments, teams, settings, and other related resources like databases and file storage. A project is comprised of different numbers of environments depending on which plan you are on. If you choose the Starter plan then the project comes with a single live environment and you have the option to add a development environment and a staging environment. If you choose the Professional plan the project will have a Development AND a Live environment. As with the Starter Plan you can add/remove environments as needed.
When your project is running in trial mode your live environment is protected with the basic authentication. The basic authentication will be removed when you pay for the project. Development and Staging environments are always protected with basic authentication
You can avoid basic authentication by whitelisting IP adresses for the appropriate environments. See IP Whitelist for more information.
Set up and Code
For developers, you will use the Development environment to set up the site. To create and test code, clone Development to your local machine and then, once things are just how you like, push the changes back to Umbraco Cloud. Your changes will be added to the Development environment automatically and added to the deployment queue. To deploy to the Live environment, simply push the deploy button and everything will be deployed to the Live environment. See more about this in the deployment section.
For content editors, you will use the Live environment to create and edit your content. Developers can always restore to the latest content on the Development or local environments.
If the project contains a Staging environment and you create your content here, be aware that content doesn't get added to the deployment queue automatically. Once you're ready to deploy the content to the Live environment, add it to the deployment queue using the Queue for transfer feature in the backoffice.
Finding your Umbraco Project
To navigate to your project, simply log in to the Umbraco Cloud portal and then click on the project you want to use.
We create your project’s URL using the name you used when you created the project, and then we add s1.umbraco.io. If you named your project Snoopy, your project URL will be snoopy.s1.umbraco.io and your project’s Umbraco backoffice URL will be snoopy.s1.umbraco.io/umbraco. For the Development environment we prefix with dev- so the URLs will be dev-snoopy.s1.umbraco.io and dev-snoopy.s1.umbraco.io/umbraco. You'll find all environments for a project listed on the Project page.
Logging in to Umbraco
When working with a trial project on Umbraco Cloud you need to log in to work with the Umbraco backoffice and also to view your site. The user name and password for both locations are the same as the username and password you use for the portal. Once you upgrade to any of the non-Trial versions you’ll no longer need to login to view your live site but, of course, will still need to log in to the backoffice.
From your Project page select the Go To Backoffice link to login to the backoffice and the View Page link to view your site.
Making changes to your site
Starting with a Baseline
Beyond the basics of creating a new project, you may wish to start with a Baseline project. Read more about Baselines and how to work with Baseline Projects.