From 5df016f12b489cf010d4e3e99364e3fd5daced54 Mon Sep 17 00:00:00 2001 From: arhimede Date: Tue, 17 Feb 2026 20:00:37 +0200 Subject: [PATCH 1/3] Enhance installation guide with troubleshooting tips Added troubleshooting tips for server error 500 and missing services. Signed-off-by: arhimede --- docs/book/v7/installation/test-the-installation.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/book/v7/installation/test-the-installation.md b/docs/book/v7/installation/test-the-installation.md index 7175169..35ade38 100644 --- a/docs/book/v7/installation/test-the-installation.md +++ b/docs/book/v7/installation/test-the-installation.md @@ -12,6 +12,8 @@ We recommend running your applications in WSL: You should see the `Dotkernel Admin` login page. +> If you are getting server error 500, please check the folders permissions [Common permission issues](https://docs.dotkernel.org/development/v2/faq/#how-do-i-fix-common-permission-issues) + > If you are getting exceptions or errors regarding some missing services, try running the following command: ```shell From 0029094edb7f2896a9fbb7541e93c45441a35381 Mon Sep 17 00:00:00 2001 From: arhimede Date: Wed, 18 Feb 2026 12:15:13 +0200 Subject: [PATCH 2/3] Update installation instructions with troubleshooting tips Added troubleshooting command for missing services. Signed-off-by: arhimede --- docs/book/v7/installation/test-the-installation.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/book/v7/installation/test-the-installation.md b/docs/book/v7/installation/test-the-installation.md index 35ade38..2397812 100644 --- a/docs/book/v7/installation/test-the-installation.md +++ b/docs/book/v7/installation/test-the-installation.md @@ -10,10 +10,10 @@ We recommend running your applications in WSL: - Set `$baseUrl` in **config/autoload/local.php** to the address of the virtualhost. - Run the application by opening the virtualhost address in your browser. -You should see the `Dotkernel Admin` login page. - > If you are getting server error 500, please check the folders permissions [Common permission issues](https://docs.dotkernel.org/development/v2/faq/#how-do-i-fix-common-permission-issues) +You should see the `Dotkernel Admin` login page. + > If you are getting exceptions or errors regarding some missing services, try running the following command: ```shell From 93d5eb8d94d2b4a33f30ea88b83cf99b9f60283e Mon Sep 17 00:00:00 2001 From: arhimede Date: Wed, 18 Feb 2026 12:18:07 +0200 Subject: [PATCH 3/3] Update AlmaLinux version in installation guide Signed-off-by: arhimede --- docs/book/v7/installation/test-the-installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/book/v7/installation/test-the-installation.md b/docs/book/v7/installation/test-the-installation.md index 2397812..9d2afad 100644 --- a/docs/book/v7/installation/test-the-installation.md +++ b/docs/book/v7/installation/test-the-installation.md @@ -5,7 +5,7 @@ We recommend running your applications in WSL: - Make sure you have [WSL2](https://docs.dotkernel.org/development/v2/setup/system-requirements/) installed on your system. -- Currently, we provide a distro implementation for [AlmaLinux9](https://github.com/dotkernel/development/blob/main/wsl/README.md). +- Currently, we provide a distro implementation for [AlmaLinux 10](https://docs.dotkernel.org/development/v2/running/). - Install the application in a virtualhost as recommended by the chosen distro. - Set `$baseUrl` in **config/autoload/local.php** to the address of the virtualhost. - Run the application by opening the virtualhost address in your browser.