From 281d3a962cfd92b1bc3fa7a03d8061ff228e934d Mon Sep 17 00:00:00 2001
From: reverse <mike.chevronnet@gmail.com>
Date: Sun, 30 Aug 2026 21:17:34 +0000
Subject: [PATCH] docker: container image (Dockerfile + .dockerignore + minimal
 default config)

---
 .dockerignore       | 18 ++++++++++++++++++
 Dockerfile          | 33 +++++++++++++++++++++++++++++++++
 docker/default.conf | 14 ++++++++++++++
 3 files changed, 65 insertions(+)
 create mode 100644 .dockerignore
 create mode 100644 Dockerfile
 create mode 100644 docker/default.conf

diff --git a/.dockerignore b/.dockerignore
new file mode 100644
index 0000000..2ad2cac
--- /dev/null
+++ b/.dockerignore
@@ -0,0 +1,18 @@
+# Keep the build context small and secret-free. Only the release binary, the
+# example config, and docker/default.conf are COPYed into the image.
+.git
+tls/
+*.pem
+*.key
+echoircd.conf
+*.bak
+*.bak-*
+config.toml.bak*
+target/debug/
+target/release/deps/
+target/release/build/
+target/release/incremental/
+target/release/.fingerprint/
+target/release/examples/
+target/.rustc_info.json
+target/CACHEDIR.TAG
diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 0000000..e512d2d
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,33 @@
+# echoIRCd container image.
+#
+# The release binary is COPYed in, so build it first, then build the image:
+#   cargo build --release
+#   docker build -t git.devtronic.pro/echo/echoircd:$(grep -m1 '^version' Cargo.toml | cut -d'"' -f2) .
+#
+# Run it (plaintext 6667 out of the box; mount your own config for TLS/opers/links):
+#   docker run -p 6667:6667 git.devtronic.pro/echo/echoircd
+#   docker run -p 6697:6697 -v $PWD/echoircd.conf:/etc/echoircd/echoircd.conf \
+#              -v $PWD/tls:/etc/echoircd/tls git.devtronic.pro/echo/echoircd
+FROM debian:trixie-slim
+
+LABEL org.opencontainers.image.source="https://git.devtronic.pro/echo/echoIRCd" \
+      org.opencontainers.image.title="echoIRCd" \
+      org.opencontainers.image.description="A from-scratch IRC daemon written in Rust." \
+      org.opencontainers.image.licenses="MIT"
+
+RUN apt-get update \
+ && apt-get install -y --no-install-recommends libssl3 ca-certificates \
+ && rm -rf /var/lib/apt/lists/* \
+ && useradd -r -u 10000 -s /usr/sbin/nologin echoircd
+
+COPY target/release/echoircd /usr/local/bin/echoircd
+COPY echoircd.conf.example   /etc/echoircd/echoircd.conf.example
+COPY docker/default.conf     /etc/echoircd/echoircd.conf
+
+# 6667 plaintext · 6697 direct TLS · 7799 WebSocket (wss) · 7700 server-to-server
+EXPOSE 6667 6697 7700 7799
+
+USER echoircd
+WORKDIR /etc/echoircd
+ENTRYPOINT ["/usr/local/bin/echoircd"]
+CMD ["/etc/echoircd/echoircd.conf"]
diff --git a/docker/default.conf b/docker/default.conf
new file mode 100644
index 0000000..472a572
--- /dev/null
+++ b/docker/default.conf
@@ -0,0 +1,14 @@
+# Minimal default configuration baked into the container image so it runs out of
+# the box on plaintext port 6667. For a real deployment provide your own config
+# (TLS, opers, links, cloak secret) by mounting over /etc/echoircd/echoircd.conf
+# or passing a path as the command.
+server {
+    name        "echoircd.local";
+    network     "echoIRCd";
+    sid         "0AA";
+    description "echoIRCd (container)";
+}
+
+listen { ip "[::]"; port 6667; }              # plaintext clients
+
+cloak { key "please-change-this-cloak-key-to-a-long-random-secret"; }