aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorXe Iaso <me@xeiaso.net>2025-04-19 10:19:21 -0400
committerXe Iaso <me@xeiaso.net>2025-04-19 10:19:21 -0400
commit44139b7222e3ebb59579c6ee169159c607a56929 (patch)
tree1f65f26ad53f03ac585a6b2935c77c54693e4c2b
parenta3dc8c4ed7918df92cc04ce7f9cb5e09ef4256cb (diff)
downloadanubis-44139b7222e3ebb59579c6ee169159c607a56929.tar.xz
anubis-44139b7222e3ebb59579c6ee169159c607a56929.zip
docs/admin/installation: add selinux troubleshootingXe/apache-docs
Signed-off-by: Xe Iaso <me@xeiaso.net>
-rw-r--r--docs/docs/admin/installation.mdx16
1 files changed, 16 insertions, 0 deletions
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: