deandegil/genieacs

GenieACS Docker

Production-ready Docker containers and deployment tools for GenieACS - an open-source implementation of TR-069 ACS (Auto Configuration Server).

---

🚀 Quick Start

Docker Run

bash
docker run -d \
  --name genieacs \
  -p 7547:7547 \
  -p 7557:7557 \
  -p 7567:7567 \
  -p 3000:3000 \
  -e GENIEACS_MONGODB_CONNECTION_URL=mongodb://your-mongo-host/genieacs \
  -e GENIEACS_UI_JWT_SECRET=changeme \
  deandegil/genieacs:latest

Docker Compose

bash
# Clone repository
git clone https://github.com/deandegil/genieacs-docker.git
cd genieacs-docker

# Start services
docker compose up -d

# Access UI
# http://localhost:3000

Portainer

1. Go to Stacks → Add Stack
2. Paste the docker-compose.yml from repository
3. Deploy the stack
4. Access UI at [***]

---

✨ Features

• 🐳 Production-ready Docker images for GenieACS v1.2.13.2
• ☸️ Official Helm chart for Kubernetes deployments
• 🔄 Multi-stage builds for optimized image size
• 🔒 Security best practices (non-root user, security contexts)
• 📊 Health checks and monitoring support
• 📦 Multi-architecture support (amd64, arm64)
• 🛠️ Easy configuration via environment variables
• 📈 Scalable with load balancing support

---

📋 Ports

---

🔧 Environment Variables

---

📦 Tags

• latest - Most recent stable version
• 1.2.13.2 - Specific GenieACS version
• 1.2.13.x - Version specific tags (when available)

---

🗄️ Volumes

• /opt/genieacs/ext - Extension scripts directory
• /var/log/genieacs - Log files directory

---

🐳 Docker Compose Example

Complete docker-compose.yml with MongoDB:

yaml
version: '3.8'

services:
  genieacs:
    image: deandegil/genieacs:latest
    container_name: genieacs
    depends_on:
      mongo:
        condition: service_healthy
    ports:
      - "7547:7547"  # CWMP
      - "7557:7557"  # NBI
      - "7567:7567"  # FS
      - "3000:3000"  # UI
    environment:
      GENIEACS_MONGODB_CONNECTION_URL: mongodb://mongo/genieacs
      GENIEACS_UI_JWT_SECRET: changeme
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "wget", "--spider", "--quiet", "http://localhost:3000"]
      interval: 30s
      timeout: 10s
      retries: 3

  mongo:
    image: mongo:8.0
    container_name: mongo
    restart: unless-stopped
    volumes:
      - mongo-data:/data/db
    healthcheck:
      test: ["CMD", "mongosh", "--eval", "db.adminCommand('ping')"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  mongo-data:

---

🔐 Security ***ations

• ✅ Container runs as non-root user (genieacs)
• ✅ Security contexts configured for Kubernetes
• ⚠️ IMPORTANT: Change GENIEACS_UI_JWT_SECRET in production
• ⚠️ IMPORTANT: Enable MongoDB authentication for production
• 🔒 Use reverse proxy (Nginx/Traefik) for HTTPS in production

---

📚 Documentation

• GitHub Repository: https://github.com/deandegil/genieacs-docker
• Full Documentation: https://github.com/deandegil/genieacs-docker/blob/main/README.md
• GenieACS Official: https://github.com/genieacs/genieacs
• GenieACS Wiki: https://github.com/genieacs/genieacs/wiki

---

🛠️ Kubernetes/Helm Deployment

Using Official Helm Chart

bash
# Add chart repository
helm repo add genieacs https://deandegil.github.io/genieacs-docker
helm repo update

# Install GenieACS
helm install genieacs genieacs/genieacs \
  --namespace genieacs \
  --create-namespace \
  --set mongodb.enabled=true \
  --set env.GENIEACS_UI_JWT_SECRET=your-secret-here

Using Helmfile

See repository for complete Helmfile example with MongoDB integration.

---

🐛 Troubleshooting

Container not starting?

bash
# Check logs
docker logs genieacs

# Check container status
docker inspect genieacs

MongoDB connection error?

• Verify MongoDB is running and accessible
• Check connection string format
• Ensure authentication credentials are correct

Web UI not responding?

bash
# Test UI endpoint
curl http://localhost:3000

# Check UI logs specifically
docker compose logs genieacs | grep "genieacs-ui"

---

🔄 Updates & Versioning

• Regular updates with latest GenieACS releases
• Security patches applied pro***ly
• Backward compatibility maintained where possible

---

📝 License

Licensed under the same license as GenieACS. See repository for details.

---

💬 Support

• Issues: https://github.com/deandegil/genieacs-docker/issues
• Discussions: https://github.com/deandegil/genieacs-docker/discussions
• GenieACS Community: https://github.com/genieacs/genieacs/discussions

---

👤 Maintainer

Dean Degil - https://github.com/deandegil

---

🙏 Contributing

Contributions are welcome! Please see repository for contribution guidelines.

---

Last Updated: January 26, 2026