Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion .github/styles/UmbracoDocs/Acronyms.yml
Original file line number Diff line number Diff line change
Expand Up @@ -48,4 +48,5 @@ exceptions:
- XSLT
- AJAX
- YAML
- PNG
- PNG
- ISO
71 changes: 15 additions & 56 deletions umbraco-cms/fundamentals/setup/requirements.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# Requirements
# System Requirements

## Browsers

The Umbraco UI should work in all modern browsers:
The Umbraco UI works in all modern browsers:

* Chrome (Latest)
* Edge (Chromium)
Expand All @@ -11,93 +11,52 @@ The Umbraco UI should work in all modern browsers:

## Local Development

{% tabs %}
{% tab title="Umbraco 10" %}
* Either OS:
* Microsoft Windows 7 SP1, 8.1, 10 and 11
* Microsoft Windows 10 or 11
* MacOS High Sierra 10.13
* Linux (Ubuntu, Alpine, CentOS, Debian, Fedora, openSUSE and other major distributions)
* One of the following .NET Tools or Editors:
* [Visual Studio Code](https://code.visualstudio.com/) with the [IISExpress extension](https://marketplace.visualstudio.com/items?itemName=warren-buckley.iis-express)
* [Microsoft Visual Studio](https://www.visualstudio.com/) 2022
* [JetBrains Rider](https://www.jetbrains.com/rider) **version 2020.3 and higher**
* [Microsoft Visual Studio](https://www.visualstudio.com/) 2022 v17.4
* [JetBrains Rider](https://www.jetbrains.com/rider) **version 2022.3 and higher**
* .NET Core CLI
* .NET 6.0.5+
* .NET 7.0
* SQL connection string (SQL Server)
{% endtab %}

{% tab title="Umbraco 9" %}
* Either OS:
* Microsoft Windows 7 SP1, 8.1, 10 and 11
* MacOS High Sierra 10.13
* Linux (Ubuntu, Alpine, CentOS, Debian, Fedora, openSUSE and other major distributions)
* One of the following .NET Tools or Editors:
* [Visual Studio Code](https://code.visualstudio.com/) with the [IISExpress extension](https://marketplace.visualstudio.com/items?itemName=warren-buckley.iis-express)
* [Microsoft Visual Studio](https://www.visualstudio.com/) 2019 **version 16.8 and higher**
* [JetBrains Rider](https://www.jetbrains.com/rider) **version 2020.3 and higher**
* .NET Core CLI
* .NET 5.0
* SQL connection string (SQL Server)
{% endtab %}
{% endtabs %}

## Hosting

### Recommendation

For the best experience, we would recommend that you ensure your hosting environment has the following to run Umbraco CMS:

{% tabs %}
{% tab title="Umbraco 10" %}
* Windows Server 2019 and higher
* IIS 10 and higher
* SQL Server 2019 and higher
* .NET 6.0.5+
* Ability to set file permissions to include create/read/write (or better) for the user that "owns" the Application Pool for your site (NETWORK SERVICE, typically)
{% endtab %}

{% tab title="Umbraco 9" %}
* Windows Server 2019 and higher
* IIS 10 and higher
* SQL Server 2019 and higher
* .NET 5.0
* .NET 7.0
* Ability to set file permissions to include create/read/write (or better) for the user that "owns" the Application Pool for your site (NETWORK SERVICE, typically)
{% endtab %}
{% endtabs %}

{% hint style="info" %}
You can use Umbraco Cloud to manage the hosting infrastructure. All Umbraco Cloud plans are hosted on Microsoft Azure, which gives your site a proven and solid foundation.
{% hint style="success" %}
You can use [Umbraco Cloud](https://umbraco.com/products/umbraco-cloud/) to manage the hosting infrastructure. All Umbraco Cloud plans are hosted on Microsoft Azure, which gives your site a proven and solid foundation.
{% endhint %}

### Miminium requirements to run Umbraco

Umbraco can run on an environment with the minimum requirements stated below:

{% tabs %}
{% tab title="Umbraco 10" %}
* Windows Server 2012 R2 and higher
* IIS 8.5 and higher
* SQL Server 2012 and higher
* .NET 6.0.5+
* SQL Server 2012 and higher / SQLite 3.38.0 or higher
* .NET 7.0
* Ability to set file permissions to include create/read/write (or better) for the user that "owns" the Application Pool for your site (NETWORK SERVICE, typically)
{% endtab %}

{% tab title="Umbraco 9" %}
* Windows Server 2012 R2 and higher
* IIS 8.5 and higher
* SQL Server 2012 and higher
* .NET 5.0
* Ability to set file permissions to include create/read/write (or better) for the user that "owns" the Application Pool for your site (NETWORK SERVICE, typically)
{% endtab %}
{% endtabs %}

_For more information, see the_ [_Host and deploy ASP.NET Core applications_](https://docs.microsoft.com/en-us/aspnet/core/host-and-deploy/?view=aspnetcore-6.0) _article in the Microsoft documentation._
*For more information, see the [Host and deploy ASP.NET Core applications](https://learn.microsoft.com/en-us/aspnet/core/host-and-deploy/?view=aspnetcore-7.0) article in the Microsoft documentation.*

## Database Account Roles

The database account used in the connection string will need permissions to read and write from tables as well as create schema during installs and upgrades:
The database account used in the connection string will need permissions to read and write from tables. It will also require permission to create schema during installs and upgrades:

* The `db_owner` role has full permissions on the database.

* To use an account with more restricted permissions, the `db_datareader` and `db_datawriter` roles will be needed for normal use to read from and write to the database. The `db_ddladmin` role, which can modify the database schema, is required for installs and upgrades of the CMS and/or any packages that create database tables.

For more information on the Database-level roles, see the [Microsoft documentation](https://docs.microsoft.com/en-us/sql/relational-databases/security/authentication-access/database-level-roles?view=sql-server-ver16#fixed-database-roles).
For more information on the Database-level roles, see the [Microsoft documentation](https://docs.microsoft.com/en-us/sql/relational-databases/security/authentication-access/database-level-roles?view=sql-server-ver16#fixed-database-roles).
61 changes: 44 additions & 17 deletions umbraco-cms/reference/configuration/installdefaultdatasettings.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,23 +21,24 @@ The following example configuration shows how this default data installation can
"Umbraco": {
"CMS": {
"InstallDefaultData": {
"Languages": {
"InstallData": "Values",
"Values": [
"en-US"
]
},
"DataTypes": {
"InstallData": "ExceptValues",
"Values": [
"0225af17-b302-49cb-9176-b9f35cab9c17"
]
},
"MediaTypes": {
"InstallData": "All",
},
"MemberTypes": {
"InstallData": "None"
"Languages": {
"InstallData": "Values",
"Values": [
"en-US"
]
},
"DataTypes": {
"InstallData": "ExceptValues",
"Values": [
"0225af17-b302-49cb-9176-b9f35cab9c17"
]
},
"MediaTypes": {
"InstallData": "All",
},
"MemberTypes": {
"InstallData": "None"
}
}
}
}
Expand All @@ -50,6 +51,32 @@ Each `InstallData` setting can be one of the following values:
- `ExceptValues` - all default data except those specified will be installed.
- `None` - no default data of the type will be installed.

## Data Identifiers

For `DataTypes`, `MediaTypes` and `MemberTypes` the Guid identifiers for the default data items need to be provided in the `Values` collection.

For `Languages`, the `Values` collection expects the standard language ISO codes to be provided. Given this code is enough to fully specify a language, it's possible to use this collection to install additional default data.

As an example, the following configuration would omit the default "English (United States)" language and instead install the "English (United Kingdom)" and "Italian" languages. As "English (United Kingdom)" is provided first, it would be created as Umbraco's default language for content creation.

```json
"Umbraco": {
"CMS": {
"InstallDefaultData": {
"Languages": {
"InstallData": "Values",
"Values": [
"en",
"it"
]
}
}
}
}
```

## Reference

The Guid values representing the default Data, Media, and Member Types installed are as follows.

Data types:
Expand Down