http://wiki.folk.zone/ 2026-06-21T12:07:50+00:00 http://wiki.folk.zone/ http://wiki.folk.zone/lib/exe/fetch.php?media=wiki:dokuwiki.svg text/html 2026-06-20T05:25:11+00:00 Anonymous (anonymous@undisclosed.example.com) http://wiki.folk.zone/doku.php?id=folkzone:troubleshooting:beszel_agent_401_unauthorized&rev=1781933111&do=diff Beszel Agent 401 Unauthorized Beszel agent getting 401 Unauthorized errors when connecting to Beszel hub. Symptom beszel-agent logs show: `WARN WebSocket connection failed err=“unexpected status code: 401”` Cause The beszel-agent is not on the same Docker network as beszel, preventing container name resolution. Using `network_mode: host` prevents the agent from resolving the beszel container name. text/html 2026-06-20T05:25:11+00:00 Anonymous (anonymous@undisclosed.example.com) http://wiki.folk.zone/doku.php?id=folkzone:troubleshooting:caddy_502_bad_gateway&rev=1781933111&do=diff Caddy 502 Bad Gateway Services show 502 Bad Gateway errors. Symptom Services show 502 Bad Gateway errors. Caddy cannot reach backend containers. Services temporarily unavailable after configuration changes. Cause Caddy and backend containers are not on the same Docker network, or Caddy needs to be restarted after configuration changes. text/html 2026-06-20T05:25:11+00:00 Anonymous (anonymous@undisclosed.example.com) http://wiki.folk.zone/doku.php?id=folkzone:troubleshooting:caddy_autosave_not_loading_config&rev=1781933111&do=diff Caddy Autosave Not Loading Config Caddy continues using old configuration after Caddyfile update. Symptom Updated Caddyfile but changes don't take effect. Caddy logs show errors pointing to old ports or configuration. Services show 502 Bad Gateway after proxy configuration changes. text/html 2026-06-20T05:25:11+00:00 Anonymous (anonymous@undisclosed.example.com) http://wiki.folk.zone/doku.php?id=folkzone:troubleshooting:cloudflared_container_name_resolution&rev=1781933111&do=diff Cloudflared Container Name Resolution DEPRECATED: This troubleshooting guide is no longer relevant for folk.zone. The nitro server uses direct HTTPS via Let's Encrypt instead of Cloudflare tunnels. Cloudflared cannot resolve Docker container names. text/html 2026-06-20T05:25:11+00:00 Anonymous (anonymous@undisclosed.example.com) http://wiki.folk.zone/doku.php?id=folkzone:troubleshooting:cloudflare_dns_configuration&rev=1781933111&do=diff Cloudflare DNS Configuration DEPRECATED: This troubleshooting guide is no longer relevant for folk.zone. The nitro server uses direct HTTPS via Let's Encrypt instead of Cloudflare tunnels. Services not accessible via domain. Symptom Can access services via localhost but not via domain. text/html 2026-06-20T05:25:11+00:00 Anonymous (anonymous@undisclosed.example.com) http://wiki.folk.zone/doku.php?id=folkzone:troubleshooting:docker_file_mounting_issues&rev=1781933111&do=diff Docker File Mounting Issues Container fails to start with file mounting errors. Symptom Container fails to start with “not a directory” errors. Files being mounted as directories instead of files. Configuration files not being read correctly. text/html 2026-06-20T05:25:11+00:00 Anonymous (anonymous@undisclosed.example.com) http://wiki.folk.zone/doku.php?id=folkzone:troubleshooting:docker_permission_denied&rev=1781933111&do=diff Docker Permission Denied Permission denied errors when running Docker commands. Symptom `docker compose` commands fail with permission errors. Cannot run Docker commands without sudo. Cause User is not in the docker group. Fix Add user to docker group. text/html 2026-06-20T05:25:11+00:00 Anonymous (anonymous@undisclosed.example.com) http://wiki.folk.zone/doku.php?id=folkzone:troubleshooting:dokuwiki_access_denied_for_unregistered&rev=1781933111&do=diff DokuWiki Access Denied for Unregistered Visitors Problem Unregistered visitors see “Access Denied” instead of the wiki content, even though the ACL configuration should allow public read access. Cause The `users.auth.php` file was missing from the DokuWiki configuration directory. This file is required for DokuWiki to handle user authentication and text/html 2026-06-20T05:25:11+00:00 Anonymous (anonymous@undisclosed.example.com) http://wiki.folk.zone/doku.php?id=folkzone:troubleshooting:freshrss_context_user_init_error&rev=1781933111&do=diff FreshRSS Context User Init Error FreshRSS shows “Error during context user init!” Symptom FreshRSS redirects to login page but shows initialization error. Cannot access FreshRSS interface. Cause Multiple issues can cause this: missing user account, incorrect Apache DocumentRoot, or incorrect base_url. text/html 2026-06-20T05:25:11+00:00 Anonymous (anonymous@undisclosed.example.com) http://wiki.folk.zone/doku.php?id=folkzone:troubleshooting:irc_custom_motd_not_showing&rev=1781933111&do=diff IRC Custom MOTD Not Showing Default Ergo MOTD showing instead of custom MOTD. Symptom IRC server shows default Ergo MOTD with color charts. Custom folk.zone MOTD not displaying. Cause Ergo IRCd is configured to use the default MOTD file instead of the custom MOTD file. text/html 2026-06-20T05:25:11+00:00 Anonymous (anonymous@undisclosed.example.com) http://wiki.folk.zone/doku.php?id=folkzone:troubleshooting:irc_lounge_ergo_connection&rev=1781933111&do=diff IRC Lounge Ergo Connection The Lounge cannot connect to Ergo backend. Symptom The Lounge shows “Connection closed unexpectedly: AggregateError”. Users cannot connect to IRC via web client. Error: “getaddrinfo EAI_AGAIN folkzone-irc-ergo”. text/html 2026-06-21T04:11:25+00:00 Anonymous (anonymous@undisclosed.example.com) http://wiki.folk.zone/doku.php?id=folkzone:troubleshooting:irc_self_signed_certificate&rev=1782015085&do=diff IRC Self-Signed Certificate Errors IRC clients show TLS certificate verification errors. Symptom IRC clients show TLS certificate verification errors. Error: “certificate is valid for ergo.test, localhost, not irc-direct.folk.zone”. Clients require manual certificate acceptance. text/html 2026-06-20T05:25:11+00:00 Anonymous (anonymous@undisclosed.example.com) http://wiki.folk.zone/doku.php?id=folkzone:troubleshooting:irc_users_not_seeing_each_other&rev=1781933111&do=diff IRC Users Not Seeing Each Other Users connect to IRC but don't see each other. Symptom Users connect but don't see each other. Ergo shows users as connected but they appear offline to each other. Cause This is normal Ergo behavior with built-in bouncer. Users can appear connected even when temporarily disconnected. text/html 2026-06-20T05:25:11+00:00 Anonymous (anonymous@undisclosed.example.com) http://wiki.folk.zone/doku.php?id=folkzone:troubleshooting:network_connectivity_issues&rev=1781933111&do=diff Network Connectivity Issues Services cannot communicate with each other. Symptom Services show connection errors. Cannot access services via subdomains. Cause Services are not on the same Docker network or network does not exist. Fix Steps: 1. Verify all services are on `folkzone_net` network 2. Check network exists: `docker network ls` 3. Inspect network: `docker network inspect folkzone_net` 4. Ensure containers can resolve each other by name text/html 2026-06-20T05:25:11+00:00 Anonymous (anonymous@undisclosed.example.com) http://wiki.folk.zone/doku.php?id=folkzone:troubleshooting:service_not_starting&rev=1781933111&do=diff Service Not Starting Container fails to start or restarts repeatedly. Symptom `docker compose ps` shows containers with `Exited` status. Services not accessible. Cause Multiple possible causes including configuration errors, port conflicts, or resource issues. text/html 2026-06-20T05:25:11+00:00 Anonymous (anonymous@undisclosed.example.com) http://wiki.folk.zone/doku.php?id=folkzone:troubleshooting:ssh_connection_issues&rev=1781933111&do=diff SSH Connection Issues Cannot SSH into server. Symptom Connection refused or permission denied when attempting SSH. Cause SSH service not running, SSH configuration incorrect, public key not in authorized_keys, or firewall blocking. Fix Steps: text/html 2026-06-20T05:25:11+00:00 Anonymous (anonymous@undisclosed.example.com) http://wiki.folk.zone/doku.php?id=folkzone:troubleshooting:start&rev=1781933111&do=diff folk.zone Troubleshooting Bug fixes and resolutions for folk.zone services. Overview This section documents bugs and issues that required more than five minutes to resolve. Each page is named after the root cause of the problem. Recent Issues This section will be populated as issues are encountered and resolved. text/html 2026-06-20T17:24:20+00:00 Anonymous (anonymous@undisclosed.example.com) http://wiki.folk.zone/doku.php?id=folkzone:troubleshooting:wiki_pages_ownership&rev=1781976260&do=diff DokuWiki Pages Directory Ownership Issue Problem After syncing wiki content from local to production via tar-over-SSH, DokuWiki displays the following error: The datadir ('pages') at /app/www/public/data/pages is not found, isn't accessible or writable. You should check your config and permission settings. Or maybe you want to run the installer? text/html 2026-06-20T05:25:11+00:00 Anonymous (anonymous@undisclosed.example.com) http://wiki.folk.zone/doku.php?id=folkzone:troubleshooting:writefreely_database_issues&rev=1781933111&do=diff WriteFreely Database Issues WriteFreely fails to start or uses SQLite instead of MySQL. Symptom WriteFreely container restarts repeatedly. Logs show “Connecting to sqlite3 database” instead of MySQL. Migration errors about missing tables. Admin user creation fails.