docs(CCSM): add optimize license page doc (#710)

* docs(CCSM): add optimize license page doc * style(formatting): technical review technical documentation review Co-authored-by: christinaausley <[email protected]>
camunda · Mar 25, 2022 · 0be52c1 · 0be52c1
1 parent d9b807b
commit 0be52c1
Show file tree

Hide file tree

Showing 4 changed files with 15 additions and 1 deletion.
diff --git a/docs/self-managed/optimize-deployment/setup/img/license-guide.png b/docs/self-managed/optimize-deployment/setup/img/license-guide.png
diff --git a/docs/self-managed/optimize-deployment/setup/installation.md b/docs/self-managed/optimize-deployment/setup/installation.md
@@ -126,7 +126,7 @@ You can also adjust logging levels using environment variables as described in t
 
 #### License key file
 
-If you want the Optimize Docker container to automatically recognize your [license key file]({{< ref "/user-guide/license/_index.md" >}}), you can use standard [Docker means](https://docs.docker.com/storage/volumes/) to make the file with the license key available inside the container. Replacing the `ABSOLUTE_PATH_ON_HOST_TO_LICENSE_FILE` with the absolute path to the license key file on your host can be done with the following command:
+If you want the Optimize Docker container to automatically recognize your [license key file](./license.md), you can use standard [Docker means](https://docs.docker.com/storage/volumes/) to make the file with the license key available inside the container. Replacing the `ABSOLUTE_PATH_ON_HOST_TO_LICENSE_FILE` with the absolute path to the license key file on your host can be done with the following command:
 
 ```
 docker run -d --name optimize -p 8090:8090 -p 8091:8091 \

diff --git a/docs/self-managed/optimize-deployment/setup/license.md b/docs/self-managed/optimize-deployment/setup/license.md
@@ -0,0 +1,13 @@
+---
+id: optimize-license
+title: "Optimize license key"
+description: "When you log in to Optimize for the first time, you are redirected to the license page where you can enter your license key."
+---
+
+When you log in to Optimize for the first time, you are redirected to the license page. Here, enter your license key to be able to use Camunda Optimize.
+
+![Optimize license page with no license key in the text field and submit button below](img/license-guide.png)
+
+Alternatively, you can add a file with the license key to the path `${optimize-root-folder}/config/OptimizeLicense.txt`; it will be automatically loaded to the database unless it already contains a license key.
+
+If you are using the Optimize Docker images and want Optimize to automatically recognize your license key, refer to the [installation guide](./installation.md#license-key-file) on how to achieve this.
diff --git a/sidebars.js b/sidebars.js
@@ -467,6 +467,7 @@ module.exports = {
         {
           Setup: [
             "self-managed/optimize-deployment/setup/installation",
+            "self-managed/optimize-deployment/setup/optimize-license",
             "self-managed/optimize-deployment/setup/security-instructions",
             "self-managed/optimize-deployment/setup/configuration",
             "self-managed/optimize-deployment/setup/user-management",