Skip to content

Enhance installation guide with troubleshooting tips #29

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
arhimede merged 3 commits into from
Feb 18, 2026
Merged

Enhance installation guide with troubleshooting tips #29

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
5df016f
Enhance installation guide with troubleshooting tips
arhimede Feb 17, 2026
0029094
Update installation instructions with troubleshooting tips
arhimede Feb 18, 2026
93d5eb8
Update AlmaLinux version in installation guide
arhimede Feb 18, 2026
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
4 changes: 3 additions & 1 deletion docs/book/v7/installation/test-the-installation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,13 @@
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.

> 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:
Expand Down