nephatrine/ergo-irc repository overview

⁠Ergo IRCv3 Server

This is an Alpine-based container hosting an Ergo IRC server.

IMPORTANT: The container built currently defaults to using the MariaDB database backend as this was the default and only option prior to v2.18. It is likely that we will pivot to SQLite as the default when v2.19 releases, though MariaDB will remain installed so as to not break existing installations. You can still use the configuration to switch between MariaDB and SQLite.

You can find example NGINX configuration if you'd like to use it as a reverse proxy to centralize your SSL/TLS setup in this⁠ repo.

⁠Supported Tags

• ergo-irc:2.18.0: Ergo 2.18.0

⁠Software

• Alpine Linux⁠
• Skarnet S6⁠
• s6-overlay⁠
• Ergo⁠
• MariaDB⁠

⁠Configuration

These are the configuration and data files you will likely need to be aware of and potentially customize.

• /mnt/config/etc/ircd.yaml
• /mnt/config/etc/ircd.motd

Modifications to some of these may require a service restart to pull in the changes made.

⁠Container Variables

• TZ: Time Zone (i.e. America/New_York)
• PUID: Mounted File Owner User ID
• PGID: Mounted File Owner Group ID
• MARIADB_ERGO_PASSWORD: Initial ergo_history DB Password

Once you have started up with MARIADB_ERGO_PASSWORD set, you no longer need to keep that variable - it is only used for initial setup. You can of course also manually create the ergo user and ergo_history database if you'd prefer.

⁠Testing

⁠docker-compose

services:
  ergo-irc:
    image: nephatrine/ergo-irc:latest
    container_name: ergo-irc
    environment:
      TZ: America/New_York
      PUID: 1000
      PGID: 1000
      MARIADB_ERGO_PASSWORD: hunter2
    ports:
      - 6667:6667/tcp
      - 6697:6697/tcp
      - 8097:8097/tcp
    volumes:
      - /mnt/containers/ergo-irc:/mnt/config

⁠docker run

docker run --rm -ti code.nephatrine.net/nephnet/ergo-irc:latest /bin/bash