> For the complete documentation index, see [llms.txt](https://docs.umbraco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.umbraco.com/umbraco-cms/17.latest/get-started.md). # Get Started - [Installation](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/installation.md): Instructions on installing Umbraco on various platforms using various tools. - [Requirements](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/installation/requirements.md) - [Install Using Visual Studio](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/installation/visual-studio.md): A guide to install Umbraco CMS using Visual Studio. - [Install Using Visual Studio Code](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/installation/install-umbraco-with-vs-code.md) - [Running Umbraco on Linux/macOS](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/installation/running-umbraco-on-linux-macos.md): Since Umbraco 9 it has been possible to run Umbraco CMS natively on Linux or macOS High Sierra 10.13 and newer. - [Running Umbraco in Docker Using Docker Compose](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/installation/running-umbraco-on-docker-locally.md): Running Umbraco on docker locally using docker compose - [Local IIS With Umbraco](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/installation/iis.md): This article describes how to run an Umbraco 9 site on a local IIS server. - [Installing Nightly Builds](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/installation/installing-nightly-builds.md): Instructions on installing nightly builds of Umbraco. - [Unattended Installs](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/installation/unattended-install.md) - [Upgrading and Migrating](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/upgrading-and-migrating.md): Introduces upgrades in Umbraco, describing what to consider when planning an upgrade. - [Upgrade Your Project](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/upgrading-and-migrating/upgrade-details.md): Describes how to upgrade existing installations to new versions. - [Breaking Changes Overview](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/upgrading-and-migrating/version-specific.md): Breaking changes introduced in each major version of Umbraco CMS, with notes on what to update when upgrading. - [Find Your Upgrade Path](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/upgrading-and-migrating/find-your-upgrade-path.md): Version-specific upgrade notes and breaking changes for Umbraco, covering migration paths between different versions. - [Upgrade from Umbraco 8 to the Latest Version](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/upgrading-and-migrating/find-your-upgrade-path/upgrade-from-8-to-latest.md): Learn how to upgrade your Umbraco 8 project to Umbraco 10. - [Migrate Content to Umbraco 15](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/upgrading-and-migrating/find-your-upgrade-path/migrate-content-to-umbraco-15.md): This article will help you migrate content to Umbraco 15, and outline options to skip this content migration - [Migrate Custom Property Editors to Umbraco Version 14 and Later](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/upgrading-and-migrating/find-your-upgrade-path/migrate-custom-property-editors-to-umbraco-14.md): This article helps you migrate custom Property Editors to Umbraco 14 and later - [Migrate Backoffice Extensions from AngularJS](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/upgrading-and-migrating/find-your-upgrade-path/migrate-backoffice-extensions-from-angularjs.md): Map the AngularJS concepts from Umbraco 13 backoffice extensions to Web Components, contexts, and the Umbraco HTTP Client in Umbraco 14 and later. - [Migrate Content to Umbraco 8](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/upgrading-and-migrating/find-your-upgrade-path/migrate-content-to-umbraco-8.md): This guide will show you how to migrate the content from your Umbraco 7 site to a site running Umbraco 8. - [Minor Upgrades for Umbraco 8](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/upgrading-and-migrating/find-your-upgrade-path/minor-upgrades-for-umbraco-8.md): This article provides details on how to upgrade to the next minor version when using Umbraco 8. - [Upgrade to Umbraco 7](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/upgrading-and-migrating/find-your-upgrade-path/upgrade-to-umbraco-7.md): This document should be used as a reference, not a step by step guide. Upgrading will largely depend on what version of Umbraco you are currently running, what packages you have installed and the many - [Minor Upgrades for Umbraco 7](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/upgrading-and-migrating/find-your-upgrade-path/minor-upgrades-for-umbraco-7.md): This article provides details on how to upgrade to the next minor version when using Umbraco 7. - [Migrating Macros](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/upgrading-and-migrating/find-your-upgrade-path/migrating-macros.md): Get started with developing a custom migration path for Macros to Blocks in the Rich Text Editors (RTE). - [Single Block Migration for Umbraco 18](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/upgrading-and-migrating/find-your-upgrade-path/single-block-migration.md) - [Upgrade Unattended](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/upgrading-and-migrating/upgrade-unattended.md): Learn how to enable unattended upgrades, allowing your project to upgrade without your interference. - [Downgrades and Re-Running Migrations](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/upgrading-and-migrating/downgrades-and-rerunning-migrations.md): Discusses the possibility of downgrading to a previous version, along with the related topic of re-running the migrations that have occurred during an upgrade - [Backoffice Essentials](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/backoffice-essentials.md): Learn the core workflows in the Umbraco backoffice. - [Logging In and Out](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/backoffice-essentials/logging-in-and-out.md) - [Umbraco Interface](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/backoffice-essentials/umbraco-interface.md) - [Creating, Saving and Publishing Content Options](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/backoffice-essentials/creating-saving-and-publishing-content.md) - [Finding Content](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/backoffice-essentials/finding-content.md) - [Editing Existing Content](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/backoffice-essentials/editing-existing-content.md) - [Sorting Pages](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/backoffice-essentials/ordering-pages.md): Learn how to change the sort order of pages within the content tree using the Sort function. - [Moving a Page](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/backoffice-essentials/moving-a-page.md) - [Copying a Page](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/backoffice-essentials/copying-a-page.md) - [Deleting and Restoring Pages](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/backoffice-essentials/deleting-and-restoring-pages.md) - [Sections](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/backoffice-essentials/sections.md): In this article you can learn more about the various sections you can find within the Umbraco Backoffice. - [Sidebar](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/backoffice-essentials/sidebar.md): This section explains how the concept of infinite editing using the Sidebar in the Umbraco backoffice works. - [Working with Rich Text Editors](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/backoffice-essentials/working-with-rich-text-editors.md) - [Tips & Tricks](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/backoffice-essentials/tips-and-tricks.md) - [Refreshing the Tree View](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/backoffice-essentials/tips-and-tricks/working-with-folders.md) - [Audit Trail](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/backoffice-essentials/tips-and-tricks/audit-trail.md): Learn how to use the Audit Trail to view the history of actions performed on a content page. - [Notifications](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/backoffice-essentials/tips-and-tricks/notifications.md) - [Preview Pane Responsive View](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/backoffice-essentials/tips-and-tricks/preview-pane-responsive-view.md) - [Session Timeout](https://docs.umbraco.com/umbraco-cms/17.latest/get-started/backoffice-essentials/tips-and-tricks/session-timeout.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.umbraco.com/umbraco-cms/17.latest/get-started.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.