====== IRC Management ======

Management commands for the folk.zone IRC service.

===== Start Services =====

```bash
cd /home/brennan/folkzone-new
docker compose up -d folkzone-irc-ergo folkzone-irc-lounge
```

===== Stop Services =====

```bash
cd /home/brennan/folkzone-new
docker compose stop folkzone-irc-ergo folkzone-irc-lounge
```

===== Restart Services =====

```bash
cd /home/brennan/folkzone-new
docker compose restart folkzone-irc-ergo folkzone-irc-lounge
```

===== View Logs =====

**Ergo IRCd Logs**
```bash
docker logs folkzone-irc-ergo
```

**The Lounge Logs**
```bash
docker logs folkzone-irc-lounge
```

**Follow Logs in Real-Time**
```bash
docker logs -f folkzone-irc-ergo
docker logs -f folkzone-irc-lounge
```

===== Check Service Status =====

```bash
cd /home/brennan/folkzone-new
docker compose ps folkzone-irc-ergo folkzone-irc-lounge
```

===== Reload Ergo Config =====

After modifying ircd.yaml, reload without restarting:

```bash
docker kill -s SIGHUP folkzone-irc-ergo
```

Verify successful reload:
```bash
docker logs folkzone-irc-ergo --tail 10
```

Look for "Rehash completed successfully"

===== Get Admin Credentials =====

Ergo generates admin credentials on first startup. To retrieve them:

```bash
docker logs folkzone-irc-ergo | grep "Oper username"
```

Example output: Oper username:password is admin:dW86Jv_Yv2ZnjwE6GnYm

===== Update The Lounge Config =====

After modifying irc/config.js, restart The Lounge:

```bash
docker compose restart folkzone-irc-lounge
```

===== Backup Data =====

**Backup Ergo Data**
```bash
docker run --rm -v folkzone_irc_ergo_data:/data -v $(pwd):/backup alpine tar czf /backup/folkzone_irc_ergo_data_$(date +%Y%m%d).tar.gz /data
```

**Backup The Lounge Data**
```bash
docker run --rm -v folkzone_irc_lounge_data:/data -v $(pwd):/backup alpine tar czf /backup/folkzone_irc_lounge_data_$(date +%Y%m%d).tar.gz /data
```

===== Restore Data =====

**Restore Ergo Data**
```bash
docker run --rm -v folkzone_irc_ergo_data:/data -v $(pwd):/backup alpine tar xzf /backup/folkzone_irc_ergo_data_YYYYMMDD.tar.gz
```

**Restore The Lounge Data**
```bash
docker run --rm -v folkzone_irc_lounge_data:/data -v $(pwd):/backup alpine tar xzf /backup/folkzone_irc_lounge_data_YYYYMMDD.tar.gz
```

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

  * [[folkzone:services:irc|IRC]] - Return to IRC overview
  * [[folkzone:services:irc:configuration|Configuration]] - Config file details
  * [[folkzone:services:irc:troubleshooting|Troubleshooting]] - Common issues and fixes

Last updated: 2026-06-20
  * [[folkzone:services:start|Return to folkzone:services]]