diff --git a/17/umbraco-cms/fundamentals/setup/install/install-umbraco-with-templates.md b/17/umbraco-cms/fundamentals/setup/install/install-umbraco-with-templates.md index 91500bd724a..7405e4908c3 100644 --- a/17/umbraco-cms/fundamentals/setup/install/install-umbraco-with-templates.md +++ b/17/umbraco-cms/fundamentals/setup/install/install-umbraco-with-templates.md @@ -98,6 +98,8 @@ Template options: --password Used to specify the password of the default admin user when using unattended install on development (stored as plain text). Type: string + --telemetry-level Used to specify the level of telemetry the installation will report (Minimal, Basic or Detailed). + Type: string --no-nodes-view-path Path to a custom view presented with the Umbraco installation contains no published content. Type: string diff --git a/17/umbraco-cms/fundamentals/setup/install/unattended-install.md b/17/umbraco-cms/fundamentals/setup/install/unattended-install.md index cc61a929a49..aad7011352f 100644 --- a/17/umbraco-cms/fundamentals/setup/install/unattended-install.md +++ b/17/umbraco-cms/fundamentals/setup/install/unattended-install.md @@ -8,7 +8,7 @@ This article will give you the details you need to install Umbraco unattended. ## Get clean install of Umbraco -In order to get a clean instance of Umbraco, follow our installation guide for how to [Install an Umbraco project template](install-umbraco-with-templates.md#install-umbraco-with-net-cli). +In order to get a clean instance of Umbraco, follow our installation guide for how to [Install an Umbraco project template](install-umbraco-with-templates.md#install-using-net-cli). ## Configure your database @@ -65,7 +65,8 @@ The unattended installs feature is disabled by default. In order to enable it, y "InstallUnattended": true, "UnattendedUserName": "FRIENDLY_NAME", "UnattendedUserEmail": "EMAIL", - "UnattendedUserPassword": "PASSWORD" + "UnattendedUserPassword": "PASSWORD", + "UnattendedTelemetryLevel": "Detailed" } } } @@ -74,6 +75,8 @@ The unattended installs feature is disabled by default. In order to enable it, y Remember to set the value of `InstallUnattended` to `true`. +The `UnattendedTelemetryLevel` can be set to `Minimal`, `Basic`, or `Detailed`. If omitted, `Detailed` is the default. + Alternatively you may set your configuration with Environment Variables or other means. Learn more about this in the [Microsoft .Net Core config documentation](https://docs.microsoft.com/en-us/aspnet/core/fundamentals/configuration/?view=aspnetcore-5.0#environment-variables). The keys for this would then be as follows: @@ -83,6 +86,7 @@ Umbraco__CMS__Unattended__InstallUnattended Umbraco__CMS__Unattended__UnattendedUserName Umbraco__CMS__Unattended__UnattendedUserEmail Umbraco__CMS__Unattended__UnattendedUserPassword +Umbraco__CMS__Unattended__UnattendedTelemetryLevel ``` ## Initialize the unattended install @@ -122,7 +126,8 @@ Having intellisense will help you to add your connection string and information "InstallUnattended": true, "UnattendedUserName": "FRIENDLY_NAME", "UnattendedUserEmail": "EMAIL", - "UnattendedUserPassword": "PASSWORD" + "UnattendedUserPassword": "PASSWORD", + "UnattendedTelemetryLevel": "Detailed" } } } @@ -136,7 +141,7 @@ We have added support for unattended installs with Name, Email and Password, and ### CLI ```powershell -dotnet new umbraco -n MyNewProject --friendly-name "Friendly User" --email user@email.com --password password1234 --connection-string "Server=(localdb)\Umbraco;Database=MyDatabase;Integrated Security=true" --version 10.0.0 +dotnet new umbraco -n MyNewProject --friendly-name "Friendly User" --email user@email.com --password password1234 --telemetry-level Detailed --connection-string "Server=(localdb)\Umbraco;Database=MyDatabase;Integrated Security=true" --version 10.0.0 ``` ### Visual Studio diff --git a/17/umbraco-cms/reference/configuration/unattendedsettings.md b/17/umbraco-cms/reference/configuration/unattendedsettings.md index 277d4aaf748..621ce3028ce 100644 --- a/17/umbraco-cms/reference/configuration/unattendedsettings.md +++ b/17/umbraco-cms/reference/configuration/unattendedsettings.md @@ -23,7 +23,8 @@ It's important to know that the install feature will only work if there is a con "UpgradeUnattended": true, "UnattendedUserName": "A.N. Other", "UnattendedUserEmail": "AN@Other.com", - "UnattendedUserPassword": "APasswordMeetingRequirements" + "UnattendedUserPassword": "APasswordMeetingRequirements", + "UnattendedTelemetryLevel": "Detailed" } } } @@ -56,6 +57,10 @@ This setting is used to specify the email address of the default admin user. This setting is used to specify the password of the default admin user. +## Unattended telemetry level + +This setting is used to specify the level of telemetry the installation will report. The `UnattendedTelemetryLevel` can be set to `Minimal`, `Basic`, or `Detailed`. If omitted, `Detailed` is the default. + ### Package migrations unattended Gets or sets a value indicating whether unattended package migrations are enabled.