deandegil/genieacs repository overview

⁠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

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

# 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 http://server-ip:3000⁠

⁠✨ 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:

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 Considerations

• ✅ 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

# 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?

# 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?

# 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 promptly
• 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 - GitHub⁠

⁠🙏 Contributing

Contributions are welcome! Please see repository for contribution guidelines.

Last Updated: January 26, 2026