====== 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.

===== Caddy =====

  * [[folkzone:troubleshooting:caddy_502_bad_gateway|Caddy 502 Bad Gateway]]
  * [[folkzone:troubleshooting:caddy_autosave_not_loading_config|Caddy Autosave Not Loading Config]]

===== Docker =====

  * [[folkzone:troubleshooting:docker_file_mounting_issues|Docker File Mounting Issues]]
  * [[folkzone:troubleshooting:docker_permission_denied|Docker Permission Denied]]

===== Networking =====

  * [[folkzone:troubleshooting:cloudflare_dns_configuration|Cloudflare DNS Configuration]]
  * [[folkzone:troubleshooting:cloudflared_container_name_resolution|Cloudflared Container Name Resolution]]
  * [[folkzone:troubleshooting:network_connectivity_issues|Network Connectivity Issues]]
  * [[folkzone:troubleshooting:ssh_connection_issues|SSH Connection Issues]]

===== IRC =====

  * [[folkzone:troubleshooting:irc_custom_motd_not_showing|IRC Custom MOTD Not Showing]]
  * [[folkzone:troubleshooting:irc_lounge_ergo_connection|IRC Lounge Ergo Connection]]
  * [[folkzone:troubleshooting:irc_self_signed_certificate|IRC Self-Signed Certificate Errors]]
  * [[folkzone:troubleshooting:irc_users_not_seeing_each_other|IRC Users Not Seeing Each Other]]

===== DokuWiki =====

  * [[folkzone:troubleshooting:dokuwiki_access_denied_for_unregistered|DokuWiki Access Denied for Unregistered Visitors]]
  * [[folkzone:troubleshooting:wiki_pages_ownership|DokuWiki Pages Directory Ownership Issue]]

===== Other Services =====

  * [[folkzone:troubleshooting:freshrss_context_user_init_error|FreshRSS Context User Init Error]]
  * [[folkzone:troubleshooting:writefreely_database_issues|WriteFreely Database Issues]]
  * [[folkzone:troubleshooting:beszel_agent_401_unauthorized|Beszel Agent 401 Unauthorized]]
  * [[folkzone:troubleshooting:service_not_starting|Service Not Starting]]

===== Format =====

Each troubleshooting page should include:

  * **Symptom**: What went wrong
  * **Cause**: Root cause analysis
  * **Fix**: Resolution steps
  * **Prevention**: How to avoid recurrence

===== See Also =====

  * [[folkzone:start|folk.zone Infrastructure]] - Return to infrastructure overview
  * [[folkzone:services:start|Services]] - Service documentation
  * [[troubleshooting:start|Troubleshooting Log]] - Cross-service incidents
  * [[start|Return to wiki home]]

Last updated: 2026-10-23