====== Ergo Crashes on Startup ======

**Symptoms**
Container keeps restarting with segmentation faults or config errors.

**Cause**
Mounting custom ircd.yaml before first run, or incomplete config file.

**Fix**
  1. Remove custom ircd.yaml mount from docker-compose.yml
  2. Stop containers: docker compose stop folkzone-irc-ergo folkzone-irc-lounge
  3. Delete the data volume: docker volume rm folkzone-new_folkzone_irc_ergo_data
  4. Restart with default config: docker compose up -d folkzone-irc-ergo folkzone-irc-lounge
  5. Follow [[folkzone:services:irc:setup|Setup Process]] for proper customization

**Prevention**
Always let Ergo generate default config on first run before customizing. See [[folkzone:services:irc:setup|Setup Process]].

Last updated: 2026-06-21