From d1986aa57d684d851a64f666dafb386741004dd6 Mon Sep 17 00:00:00 2001 From: Jakob Guldberg Aaes Date: Mon, 13 Apr 2026 15:37:37 +0200 Subject: [PATCH 1/2] docs: simplify APP_KEY generation command --- contributing/development-environment.md | 2 +- getting-started/installation/using-docker-compose.md | 2 +- getting-started/installation/using-docker.md | 4 ++-- security/encryption.md | 6 +++++- 4 files changed, 9 insertions(+), 5 deletions(-) diff --git a/contributing/development-environment.md b/contributing/development-environment.md index 03c5742..9138e11 100644 --- a/contributing/development-environment.md +++ b/contributing/development-environment.md @@ -46,7 +46,7 @@ APP_TIMEZONE=UTC ``` {% hint style="info" %} -Generate the APP\_KEY at with the command; `echo -n 'base64:'; openssl rand -base64 32;` +Generate the APP\_KEY with: `echo "base64:$(openssl rand -base64 32 2>/dev/null)"` {% endhint %} #### 3. Install Composer dependencies diff --git a/getting-started/installation/using-docker-compose.md b/getting-started/installation/using-docker-compose.md index 96fdaba..8050408 100644 --- a/getting-started/installation/using-docker-compose.md +++ b/getting-started/installation/using-docker-compose.md @@ -21,7 +21,7 @@ Docker run commands can be found on the [Using Docker](using-docker.md) page and Run the command below to generate a key, the key is required for [encryption](../../security/encryption.md). Copy this key including the `base64:` prefix and paste it as your `APP_KEY` value. ```bash -echo -n 'base64:'; openssl rand -base64 32; +echo "base64:$(openssl rand -base64 32 2>/dev/null)" ``` {% endstep %} diff --git a/getting-started/installation/using-docker.md b/getting-started/installation/using-docker.md index b5ff34a..62e1898 100644 --- a/getting-started/installation/using-docker.md +++ b/getting-started/installation/using-docker.md @@ -21,7 +21,7 @@ Docker run commands assume you already have a database installed and configured. Run the command below to generate a key, the key is required for [encryption](../../security/encryption.md). Copy this key including the `base64:` prefix and paste it as your `APP_KEY` value. ```bash -echo -n 'base64:'; openssl rand -base64 32; +echo "base64:$(openssl rand -base64 32 2>/dev/null)" ``` {% endstep %} @@ -150,6 +150,6 @@ During the start the container there is a default username and password created. {% endstep %} {% endstepper %} -[^1]: Generate with: `echo -n 'base64:'; openssl rand -base64 32` +[^1]: Generate with: `echo "base64:$(openssl rand -base64 32 2>/dev/null)"` [^2]: The URL where you'll access the app (e.g., `http://localhost:8080`) diff --git a/security/encryption.md b/security/encryption.md index 3132152..3b9ce2b 100644 --- a/security/encryption.md +++ b/security/encryption.md @@ -7,5 +7,9 @@ An application key (`APP_KEY`) is used for encryption. It is a base64 encoded st Run the command below to generate your `APP_KEY`. ```bash -echo -n 'base64:'; openssl rand -base64 32; +echo "base64:$(openssl rand -base64 32 2>/dev/null)" ``` + +{% hint style="info" %} +Some OpenSSL installs print a warning such as `can't open config file: etc/ssl/openssl.cnf` before the generated key. The command above suppresses that warning so you can copy a clean `APP_KEY` value. +{% endhint %} From 4d5519751fcaa4e852ed7bbfcd70b9adb1f2bee4 Mon Sep 17 00:00:00 2001 From: Jakob Guldberg Aaes Date: Mon, 13 Apr 2026 15:39:13 +0200 Subject: [PATCH 2/2] docs: remove APP_KEY OpenSSL note --- security/encryption.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/security/encryption.md b/security/encryption.md index 3b9ce2b..23deb47 100644 --- a/security/encryption.md +++ b/security/encryption.md @@ -9,7 +9,3 @@ Run the command below to generate your `APP_KEY`. ```bash echo "base64:$(openssl rand -base64 32 2>/dev/null)" ``` - -{% hint style="info" %} -Some OpenSSL installs print a warning such as `can't open config file: etc/ssl/openssl.cnf` before the generated key. The command above suppresses that warning so you can copy a clean `APP_KEY` value. -{% endhint %}