Zenc Server is the core media server for the Zenc livestreaming ecosystem. Built in Go for high performance and concurrency, it handles real-time media routing using WebRTC SFU (Selective Forwarding Unit) architecture.

• WebRTC SFU Implementation - Selective forwarding for efficient media routing
• Multi-Host Support - Distributed architecture with automatic failover
• Redis Integration - State management and pub/sub for cross-server communication
• Stream Zones - Geographic/logical grouping for better performance
• REST & WebSocket APIs - Flexible integration options
• Real-time Metrics - Prometheus-compatible metrics endpoint
• Docker Ready - Easy deployment with Docker and Docker Compose

• Go 1.22 or higher
• Redis 7.0 or higher
• Docker & Docker Compose (optional)

# Clone the repository
git clone https://github.com/aminofox/zenc-server.git
cd zenc-server

# Start the server with Redis
docker-compose up -d

# View logs
docker-compose logs -f zenc-server

# Install dependencies
make deps

# Build the server
make build

# Run the server
./zenc-server

go run ./cmd/server

Configuration is managed via config.yaml. Here's a basic example:

server:
  host: 0.0.0.0
  port: 8080
  name: zenc-server-1

webrtc:
  ice_servers:
    - urls: 
        - stun:stun.l.google.com:19302
  port_range:
    min: 10000
    max: 20000

redis:
  mode: single
  addresses:
    - localhost:6379
  password: ""
  db: 0

zones:
  - id: default
    region: local
    primary: true

logging:
  level: info
  format: json

metrics:
  enabled: true
  port: 9090
  path: /metrics

GET /health

Response:

{
  "status": "healthy",
  "server": "zenc-server-1",
  "time": 1706140800
}

POST /api/v1/rooms
Content-Type: application/json

{
  "name": "My Livestream",
  "max_users": 100,
  "zone": "default"
}

GET /api/v1/rooms/:id

GET /api/v1/rooms

DELETE /api/v1/rooms/:id

POST /api/v1/rooms/:id/join
Content-Type: application/json

{
  "user_id": "user123",
  "role": "publisher"
}

POST /api/v1/rooms/:id/leave
Content-Type: application/json

{
  "participant_id": "participant-uuid"
}

GET /api/v1/rooms/:id/participants

POST /api/v1/tracks/publish
Content-Type: application/json

{
  "participant_id": "participant-uuid",
  "kind": "video",
  "source": "camera",
  "sdp_offer": "v=0..."
}

POST /api/v1/tracks/subscribe
Content-Type: application/json

{
  "participant_id": "participant-uuid",
  "track_id": "track-uuid"
}

POST /api/v1/tracks/hold
Content-Type: application/json

{
  "track_id": "track-uuid"
}

POST /api/v1/tracks/resume
Content-Type: application/json

{
  "track_id": "track-uuid"
}

Connect to ws://localhost:8080/ws for real-time signaling.

{
  "type": "message_type",
  "payload": {
    "key": "value"
  }
}

• join - Join a room
• leave - Leave a room
• offer - WebRTC offer
• answer - WebRTC answer
• ice_candidate - ICE candidate

Prometheus metrics are available at http://localhost:9090/metrics (if enabled).

zenc-server/
├── cmd/
│   └── server/           # Main application entry point
├── internal/
│   ├── api/
│   │   ├── httpapi/      # REST API handlers
│   │   └── websocket/    # WebSocket handlers
│   ├── room/             # Room management
│   ├── participant/      # Participant logic
│   ├── media/            # Media routing (SFU core)
│   └── store/            # Redis storage layer
├── pkg/
│   ├── config/           # Configuration management
│   ├── logger/           # Logging utilities
│   └── protocol/         # Protocol definitions
├── config.yaml           # Configuration file
├── Dockerfile            # Docker image
└── docker-compose.yml    # Docker Compose setup

make test

make test-coverage

make fmt

make lint

make docker-build

# Build the image
docker build -t aminofox/zenc-server:latest .

# Run the container
docker run -d \
  --name zenc-server \
  -p 8080:8080 \
  -p 9090:9090 \
  -p 10000-20000:10000-20000/udp \
  -v $(pwd)/config.yaml:/root/config.yaml:ro \
  aminofox/zenc-server:latest

You can override configuration via environment variables:

export SERVER_PORT=8080
export REDIS_ADDR=redis:6379
export LOG_LEVEL=info

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

• Basic room management
• REST API
• WebSocket signaling
• Redis integration
• Full WebRTC implementation with Pion

• Multi-server support
• Cross-server communication
• Load balancing
• Automatic failover

• Stream composition engine
• Quality adaptation
• Recording support
• RTMP ingestion/egress

1. Check if Redis is running:

   redis-cli ping
   # Should return: PONG

2. Verify configuration file exists:

   ls -la config.yaml

3. Check logs for errors:

   docker-compose logs zenc-server

1. Ensure UDP ports 10000-20000 are open
2. Check firewall settings
3. Verify STUN server is accessible

This project is licensed under the MIT License - see the LICENSE file for details.

aminofox

• GitHub: @aminofox
• Repository: zenc-server

• zenc-sdk - Client SDK
• zenc-protocol - Protocol definitions
• zenc-admin - Admin dashboard

If you find this project helpful, please give it a star! ⭐

For questions or support, please open an issue on GitHub.

Built with ❤️ by aminofox

Part of the Zenc Livestreaming Ecosystem