safrinnetwork/genieacs-simple

GenieACS Simple (Non-ZeroTier)

https://img.shields.io/docker/image-size/safrinnetwork/genieacs-simple/latest](https://hub.docker.com/r/USERNAME/genieacs-simple) https://img.shields.io/docker/pulls/safrinnetwork/genieacs-simple](https://hub.docker.com/r/USERNAME/genieacs-simple) https://img.shields.io/badge/GenieACS-1.2.13-blue](https://github.com/genieacs/genieacs)

GenieACS adalah Auto Configuration Server (ACS) open-source untuk remote management TR-069 compliant devices seperti routers, ONUs, dan IoT devices.

Image Docker ini menyediakan instalasi GenieACS yang clean, standalone, dan production-ready tanpa dependensi ZeroTier.

🚀 Quick Start

Menggunakan Docker Run

bash
docker run -d \
  --name genieacs \
  -p 3000:3000 \
  -p 7547:7547 \
  -p 7557:7557 \
  -p 7567:7567 \
  -v genieacs-data:/data/db \
  -v genieacs-logs:/var/log/genieacs \
  USERNAME/genieacs-simple:latest

Menggunakan Docker Compose

yaml
version: '3.8'

services:
  genieacs:
    image: USERNAME/genieacs-simple:latest
    container_name: genieacs
    restart: unless-stopped
    ports:
      - "3000:3000"   # Web UI
      - "7547:7547"   # CWMP (TR-069)
      - "7557:7557"   # NBI API
      - "7567:7567"   # File Server
    volumes:
      - genieacs-data:/data/db
      - genieacs-logs:/var/log/genieacs
      - genieacs-ext:/opt/genieacs/ext
    environment:
      - TZ=Asia/Jakarta

volumes:
  genieacs-data:
  genieacs-logs:
  genieacs-ext:

Save sebagai docker-compose.yml dan jalankan:

bash
docker-compose up -d

🌐 Akses GenieACS

Setelah container berjalan, akses via browser:

• Web UI: http://localhost:3000
• CWMP (TR-069): http://localhost:7547
• NBI API: http://localhost:7557
• File Server: http://localhost:7567

Default Credentials:

• Username: admin
• Password: admin

⚠️ Penting: Segera ubah password default setelah login pertama kali!

📦 What's Included

• GenieACS: v1.2.13
• MongoDB: 4.4.x (embedded)
• Node.js: 18.x LTS
• Base OS: Ubuntu 22.04 LTS
• Supervisor: Untuk process management
• Pre-configured: Siap pakai out-of-the-box

⚙️ Environment Variables

Example dengan custom environment:

bash
docker run -d \
  --name genieacs \
  -e TZ=America/New_York \
  -e GENIEACS_UI_INTERFACE=127.0.0.1 \
  -p 3000:3000 \
  -p 7547:7547 \
  -p 7557:7557 \
  -p 7567:7567 \
  USERNAME/genieacs-simple:latest

💾 Volumes

Recommended: Gunakan named volumes atau ***d mounts untuk persistent data.

🔧 Management Commands

bash
# View logs
docker logs genieacs
docker logs -f genieacs  # Follow mode

# Access container shell
docker exec -it genieacs bash

# Check service status inside container
docker exec genieacs supervisorctl status

# Restart services
docker restart genieacs

# Stop container
docker stop genieacs

# Remove container (data akan tetap ada di volumes)
docker rm genieacs

📊 Health Check

Container includes health check yang memonitor GenieACS UI:

bash
# Check container health
docker inspect --format='{{.State.Health.Status}}' genieacs

Status yang mungkin:

• healthy - GenieACS running normal
• unhealthy - GenieACS tidak respond
• starting - Container baru start

🔒 Security Recommendations

1. Change default password setelah instalasi pertama
2. Use reverse proxy (nginx, traefik) untuk HTTPS
3. Firewall: Batasi akses ke port CWMP (7547) hanya dari trusted networks
4. Backup: Regular backup MongoDB data volume
5. Update: Keep image updated dengan pull latest tag

🛠️ Advanced Usage

Import Virtual Parameters

bash
# Copy parameter files to container
docker cp ./parameter/ genieacs:/tmp/

# Restore to MongoDB
docker exec genieacs mongorestore --db genieacs --collection config --drop /tmp/parameter/config.bson
docker exec genieacs mongorestore --db genieacs --collection virtualParameters --drop /tmp/parameter/virtualParameters.bson
docker exec genieacs mongorestore --db genieacs --collection presets --drop /tmp/parameter/presets.bson
docker exec genieacs mongorestore --db genieacs --collection provisions --drop /tmp/parameter/provisions.bson

# Restart services
docker restart genieacs

Backup & Restore

bash
# Backup MongoDB data
docker exec genieacs mongodump --db genieacs --out /tmp/backup
docker cp genieacs:/tmp/backup ./genieacs-backup-$(date +%Y%m%d)

# Restore
docker cp ./genieacs-backup-20250104 genieacs:/tmp/restore
docker exec genieacs mongorestore --db genieacs /tmp/restore/genieacs

Custom Extensions

Mount your custom extensions:

bash
docker run -d \
  --name genieacs \
  -v /path/to/your/extensions:/opt/genieacs/ext \
  -p 3000:3000 -p 7547:7547 -p 7557:7557 -p 7567:7567 \
  USERNAME/genieacs-simple:latest

🐛 Troubleshooting

Container won't start

bash
# Check logs
docker logs genieacs

# Check if ports are already in use
sudo ss -tlnp | grep -E ':(3000|7547|7557|7567)'

# Remove old container and try again
docker rm -f genieacs

GenieACS UI tidak dapat diakses

bash
# Verify container is running and healthy
docker ps | grep genieacs

# Check health status
docker inspect --format='{{.State.Health.Status}}' genieacs

# Check inside container
docker exec genieacs supervisorctl status

Database issues

bash
# Check MongoDB logs
docker exec genieacs tail -50 /var/log/mongodb/mongod.log

# Restart MongoDB
docker exec genieacs supervisorctl restart mongod

📚 Documentation

• GenieACS Official Docs
• TR-069 Protocol
• https://github.com/safrinnetwork/GACS-Ubuntu-22.04
• https://hub.docker.com/r/safrinnetwork/genieacs-simple

🤝 Contributing

Contributions are welcome! Please visit the https://github.com/safrinnetwork/GACS-Ubuntu-22.04.

📝 License

This Docker image is based on:

• https://github.com/genieacs/genieacs - AGPLv3
• Ubuntu - Various licenses

💬 Support

• Issues: https://github.com/safrinnetwork/GACS-Ubuntu-22.04/issues
• Discussions: https://github.com/safrinnetwork/GACS-Ubuntu-22.04/discussions
• Email: ***

⭐ Star History

If you find this useful, please give it a star on GitHub!

---

Built with ❤️ for the community