====== IRC ======

IRC (Internet Relay Chat) service for folk.zone using Ergo IRCd and The Lounge web client.

===== Connection Details =====

**Web Client**
  * URL: https://irc.folk.zone
  * No software installation required

**Direct IRC Client**
  * Server: irc-direct.folk.zone
  * Port: 6697 (TLS required)
  * Port: 6667 (plaintext, not recommended)
  * Certificate: Self-signed (generated by Ergo)

**Main Channel**
  * #general

===== Components =====

**Ergo IRCd**
  * Modern IRC server written in Go
  * Image: ghcr.io/ergochat/ergo:stable
  * Container: folkzone-irc-ergo
  * Ports: 6667, 6697
  * Data volume: folkzone_irc_ergo_data

**The Lounge**
  * Modern web IRC client
  * Image: ghcr.io/thelounge/thelounge:latest
  * Container: folkzone-irc-lounge
  * Port: 9000 (internal)
  * Data volume: folkzone_irc_lounge_data

===== Documentation =====

  * [[folkzone:services:irc:configuration|Configuration]] - Docker compose, config files
  * [[folkzone:services:irc:setup|Setup Process]] - Initial setup and customization
  * [[folkzone:services:irc:management|Management]] - Start, stop, restart commands
  * [[folkzone:services:irc:troubleshooting|Troubleshooting]] - Common issues and fixes

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

  * [[folkzone:services:start|folk.zone Services]] - Return to services overview
  * [[folkzone:start|folk.zone Infrastructure]] - Return to infrastructure overview

Last updated: 2026-06-20