# GenieACS

GenieACS is a self-hosted infrastructure app. Production-ready Docker image for GenieACS, an open-source TR-069 (CWMP) Auto Configuration Server. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1188/genieacs

## Description

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 with a built-in web UI, REST API, and firmware file server. Multi-arch (amd64/arm64), non-root runtime, integrated log rotation. Runs four services in one container managed by supervisord: CWMP (device communication), NBI (REST API), FS (file server), and UI (web dashboard). Requires a MongoDB instance.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

63/100 (Good), based on 4 of 4 factors.
- Maintained: 98 (last commit 14 days ago)
- Popular: 43 (135 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 40 (3 GB minimum RAM, runs on ARM)

## Links

- Docker Hub: https://hub.docker.com/r/drumsergio/genieacs
- Unraid: https://ca.unraid.net/apps/genieacs-1gg7l8i0d67852?q=genieacs
- GitHub: https://github.com/GeiserX/genieacs-container
- Official website: https://geiserx.github.io/genieacs-container

## Common questions

### Do I need a separate MongoDB for the GenieACS Docker deployment?

The image runs the GenieACS services, and MongoDB runs beside it. Docker Compose can run both on one host, and Helm can use a bundled evaluation MongoDB or your own MongoDB supplied through a Kubernetes Secret.

### Which ports are used for the web console and initial CPE communication?

The web console uses port 3000, and CPE devices inform the ACS on port 7547. On Kubernetes, you can port-forward the genieacs-http service to port 3000 to reach the console.

### What should I change before exposing the web console?

Change GENIEACS_UI_JWT_SECRET from changeme in the compose file before you expose the console.

### Can I test GenieACS before connecting real routers or ONTs?

Yes, a simulated CPE is available with the testing profile. This lets you try the console before any hardware informs.

---
Source: Our Local Host (https://ourlocalhost.com/app/1188/genieacs), the self-hosted and open-source app directory.