genieacs

Overview

Production-ready Docker image for GenieACS, an open-source TR-069 (CWMP) Auto Configuration Server. Manage and provision CPE devices (routers, ONTs, gateways) via TR-069 protocol with a built-in web UI, REST API, and firmware file server. Multi-arch (amd64/arm64), non-root runtime, integrated log rotation.

Includes 4 services managed by supervisord: CWMP (device communication), NBI (REST API), FS (file server), and UI (web dashboard).

Requires MongoDB. Set GENIEACS_MONGODB_CONNECTION_URL to your MongoDB instance.

More info: https://github.com/GeiserX/genieacs-container

Requirements

MongoDB container or external MongoDB instance

Runtime arguments

Web UI: http://[IP]:[PORT:3000]/
Network: bridge
Privileged: false

Template configuration

Web UI PortPorttcp

GenieACS web dashboard port

Target: 3000
Default: 3000

CWMP PortPorttcp

TR-069 CWMP port for CPE device communication

Target: 7547
Default: 7547

NBI PortPorttcp

Northbound Interface (REST API) port

Target: 7557
Default: 7557

FS PortPorttcp

File server port for firmware and config uploads

Target: 7567
Default: 7567

ExtensionsPathrw

Custom extension scripts directory

Target: /opt/genieacs/ext
Default: /mnt/user/appdata/genieacs/ext

LogsPathrw

Log files (rotated daily, 30-day retention)

Target: /var/log/genieacs
Default: /mnt/user/appdata/genieacs/log

MongoDB URLVariable

MongoDB connection string (e.g. mongodb://host:27017)

Target: GENIEACS_MONGODB_CONNECTION_URL
Default: mongodb://mongo:27017

JWT SecretVariable

JWT secret for web UI authentication. Change in production!

Target: GENIEACS_UI_JWT_SECRET
Default: changeme

Links

Template Support Docker Hub Project

Details

Repository

drumsergio/genieacs:latest

Registry

https://hub.docker.com/r/drumsergio/genieacs

Last Updated2026-04-01

First Seen2026-04-06

Run Genieacs on Unraid.

Genieacs is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS