From 44139b7222e3ebb59579c6ee169159c607a56929 Mon Sep 17 00:00:00 2001 From: Xe Iaso Date: Sat, 19 Apr 2025 10:19:21 -0400 Subject: docs/admin/installation: add selinux troubleshooting Signed-off-by: Xe Iaso --- docs/docs/admin/installation.mdx | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/docs/admin/installation.mdx b/docs/docs/admin/installation.mdx index f558892..2b12d76 100644 --- a/docs/docs/admin/installation.mdx +++ b/docs/docs/admin/installation.mdx @@ -200,6 +200,22 @@ Then reload your Apache config and load your website. You should see Anubis prot sudo systemctl reload httpd.service ``` +### I'm running on a Red Hat distribution and Apache is saying "service unavailable" for every page load + +If you see a "Service unavailable" error on every page load and run a Red Hat derived distribution, you are missing a `selinux` setting. The exact command will be in a log message like this: + +```text +***** Plugin catchall_boolean (89.3 confidence) suggests ****************** + +If you want to allow HTTPD scripts and modules to connect to the network using TCP. +Then you must tell SELinux about this by enabling the 'httpd_can_network_connect' boolean. + +Do +setsebool -P httpd_can_network_connect 1 +``` + +This will fix the error immediately. + ## Docker compose Add Anubis to your compose file pointed at your service: -- cgit v1.2.3