luadch-ng

Quick start

Docker

git clone https://github.com/luadch-ng/luadch.git
cd luadch
cp .env.example .env
mkdir -p cfg scripts certs log secrets
docker compose up -d

Pure-rootless multi-arch image on ghcr.io/luadch-ng/luadch (linux/amd64, linux/arm64). Entrypoint seeds the empty mounts, generates a self-signed TLS cert, and logs the keyprint on first start. See the Docker guide for details.

From source

git clone https://github.com/luadch-ng/luadch.git
cd luadch
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j
cmake --install build
cd build/install/luadch && ./luadch

First login: nick dummy, password test. Connect with an ADC client (AirDC++, EiskaltDC++, …) to adc://127.0.0.1:5000 for plain or adcs://127.0.0.1:5001 for TLS after running certs/make_cert.{sh,bat}.

Pre-built binaries for Linux x86_64 and Windows x86_64 are attached to every release.

Features

• Lua 5.4.8 with continuous CI smoke tests on Linux + Windows.
• Cross-platform CMake build for Linux, Windows (MinGW UCRT64), and ARM aarch64.
• AES-256-GCM at-rest encryption of the registered-user database.
• Per-IP and per-user rate limits, TLS handshake deadline, failed-auth lockout.
• Sandboxed config / state loaders (no RCE on tampered .tbl files).
• TLS 1.3 with AES-256-GCM cipher suites.
• ~3 MB install size; ARM-compatible (Raspberry Pi, ARM servers, Apple Silicon Linux).
• Lua scripting API for plugins; rightclick-menu support in modern clients.

Documentation

• Building from source
• Installing
• Configuration
• Security model
• Docker guide
• Changelog

About

luadch-ng is the modernised fork of luadch by blastbeat and pulsar. The project was forked at upstream's v2.24 RC4, lifted off Lua 5.1 (EOL 2012), rebuilt under CMake, security-audited across seven phases, and released as v3.1.0 in May 2026. Maintained by Aybo with help from Claude.

Bug reports, feature requests, and security advisories: issue tracker.