From b4441baade62d5d6c72ab1417eae8f7dca49108f Mon Sep 17 00:00:00 2001 From: Ruan <2369127-ruany@users.noreply.gitlab.com> Date: Fri, 24 Jun 2022 15:50:56 +0000 Subject: [PATCH] Update Installation --- Installation.md | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/Installation.md b/Installation.md index 03afbdd..cc035e1 100644 --- a/Installation.md +++ b/Installation.md @@ -55,23 +55,25 @@ To use the web interface in a container environment, see [Docker](https://gitlab ## Troubleshooting If you're using a web host's database, contact them to find out whether their database accepts remote connections. Most [web hosts](https://gitlab.com/ruany/LiteBans/-/wikis/MySQL-Errors#hosts) do not provide this for free plans. -If you get redirected to the wrong page when trying to access bans (e.g. Multicraft admin panel instead of the web interface): +If you get an error "404 Not Found" / "The requested URL was not found on this server": +- FTP clients have settings for file permissions, ensure that these are correct if you are using FTP to upload files. +- Check that the directory has the **correct file permissions** (`chmod -R 755 /var/www` + `chown -R www-data /var/www`) especially after moving files across servers. +- Check that you've extracted it to the correct directory (if the "public_html" folder exists, extract to that folder) + +If you get **redirected** to the wrong page when trying to access bans (e.g. Multicraft admin panel instead of the web interface): - Set up different subdomains for each web installation you have, instead of putting everything on the same domain/subdomain. - Also set up different virtual-hosts for everything that should be installed separately, if needed. Each web package should get its own directory to prevent conflicts. -If you get an error "404 Not Found" / "The requested URL was not found on this server": -- Check that the directory has the correct file permissions (`chmod -R 755` + `chown -R www-data`) especially after moving files across servers. -- Check that you've extracted it to the correct directory (if the "public_html" folder exists, extract to that folder) - -If you are unable to connect to `localhost` but are certain that there is a database server running on the local machine: +If you are **unable to connect** to `localhost` but are certain that there is a database server running on the local machine: - Try setting the host to `127.0.0.1` instead of `localhost`. This switches the connection method to TCP. (`localhost` uses local UNIX socket) -For other database errors: +For **other database errors**: - See https://gitlab.com/ruany/LiteBans/-/wikis/MySQL-Errors -If bans don't show up: +If bans **don't show up**: +- Ensure that the `table_prefix` is set correctly. - Try /litebans:ban - if this works and /ban doesn't, then another plugin is overriding the command. See [Command Aliases](https://gitlab.com/ruany/LiteBans/wikis/Command-Aliases) - Log into the database and see if the tables contain the relevant data. -If skins/avatars are not showing correctly: +If **skins/avatars** are not showing correctly: - Change the `avatar_source` in settings.php. Three example sources are indicated above the option. \ No newline at end of file