Troubleshooting Installation Problems¶
If you cannot connect to the Web UI even after waiting for a while, run this command to display the last 100 log messages:
docker-compose logs --tail=100
Search them for messages like disk full, wrong permissions, and database connection failed before reporting a bug.
If you see no errors or no logs at all, you may have started the server on a different host and/or port. There could also be an issue with your browser, ad blocker, or firewall settings.
You can also try (re-)starting the app and database without
-d. This keeps their containers running
in the foreground and shows log messages for troubleshooting:
docker-compose stop docker-compose up
If you can't use
docker-compose at all, make sure Docker
is running on the host and your current user has the permission to use it.
Many Linux distributions require you to install
docker-compose separately, for example by
sudo apt install docker-compose in a terminal or using a graphical software package manager.
Commands on Linux may have to be prefixed with
sudo when not running as root. Note that this will
point the home directory placeholder
/root in volume mounts.
To enable debug mode in your
Fatal errors are often caused by one of the following conditions:
- Your (virtual) server disk is full
- There is disk space left, but the inode limit has been reached
- The storage folder is not writable or there are other filesystem permission issues
- You have accidentally mounted the wrong folders
- The server is low on memory
- The database server is not available, incompatible or incorrectly configured
- There are network problems caused by a proxy, firewall or unstable connection
- Kernel security modules such as AppArmor and SELinux are blocking permissions
Linux kernel security can be disabled on private servers, especially if you do not have experience with the configuration.
Use a file manager, or the commands
chown on Unix-like operating systems,
to verify and fix filesystem permissions.
Available disk space can be displayed with
df -h. The size of virtual disks and memory can be
increased in Docker and VM settings if needed. Please refer to the documentation.