Instalasi

Liodra didistribusikan sebagai satu image Docker yang sudah memuat media engine dan seluruh dependensinya. Satu container cukup; tidak ada database atau layanan eksternal yang dibutuhkan. Seluruh state (device, kebijakan retensi, rekaman, video unggahan) hidup di satu volume storage.

Persyaratan

Image

Image dipublikasikan di GitLab Container Registry Nodeflux. Login terlebih dahulu dengan kredensial GitLab Anda:

docker login registry.gitlab.com -u <gitlab-username>

Tag yang tersedia: latest (branch main), test (merge request), dan <versi> untuk rilis (mis. 3.9.0). Untuk produksi selalu gunakan tag versi.

Quick Start

mkdir -p /srv/liodra/storage

docker run -d \
  --name liodra \
  --restart unless-stopped \
  --ulimit nofile=65535:65535 \
  -p 9080:9080 \
  -p 1935:1935 \
  -p 8554:8554 \
  -v /srv/liodra/storage:/usr/share/nginx/html/storage \
  registry.gitlab.com/nodefluxio/liodra:3.9.0 \
  --as-nvr --set-retention

docker run -d \
  --name liodra \
  --restart unless-stopped \
  --ulimit nofile=65535:65535 \
  -p 9080:9080 \
  -p 1935:1935 \
  -p 8554:8554 \
  -p 9994:9994 \
  -v /srv/liodra/storage:/usr/share/nginx/html/storage \
  registry.gitlab.com/nodefluxio/liodra:3.9.0 \
  --as-nvr --set-retention --with-vod --broadcast-on

docker run -d \
  --name liodra \
  --restart unless-stopped \
  --ulimit nofile=65535:65535 \
  -p 9080:9080 \
  -p 1935:1935 \
  -v /srv/liodra/storage:/usr/share/nginx/html/storage \
  registry.gitlab.com/nodefluxio/liodra:3.9.0

curl http://localhost:9080/api/v1/health
curl http://localhost:9080/api/v1/version
docker logs -f liodra

curl -X POST http://localhost:9080/api/v1/devices/rtsp \
  -H "Content-Type: application/json" \
  -d '{
    "name": "camera_front",
    "url": "rtsp://admin:[email protected]:554/stream1",
    "channel": "live"
  }'

Flag Fitur

Argumen container dipetakan ke environment variable. Keduanya setara; flag lebih praktis untuk docker run, variable lebih praktis untuk Compose atau orkestrator.

Port

Port lain yang mungkin muncul di docker-compose.yaml repositori bersifat internal dan tidak dipakai oleh Lenz maupun Visionaire; jangan diekspos.

Volume dan Tata Letak Storage

Satu volume, /usr/share/nginx/html/storage, menampung semuanya:

storage/
├── recordings.yaml          # daftar device (dipersist tiap 60 s dan saat berubah)
├── retentions.yaml          # jadwal cleanup dan kebijakan retensi
├── recordings/              # segmen DVR: {channel}/{name}/YYYY/MM/DD/HH-mm-ss.flv (UTC)
├── vods/                    # video unggahan beserta .info dan .thumb.jpg
├── logs/                    # log per proses ingest
└── transcode-capacity.json  # cache benchmark encoder (hanya mode eksperimental)

Device di recordings.yaml dipulihkan otomatis saat container dimulai ulang, sehingga kamera kembali di-ingest tanpa perlu didaftarkan lagi.

Docker Compose

services:
  liodra:
    image: registry.gitlab.com/nodefluxio/liodra:3.9.0
    restart: unless-stopped
    command: ["--as-nvr", "--set-retention", "--with-vod"]
    ulimits:
      nofile:
        soft: 65535
        hard: 65535
    ports:
      - "9080:9080"
      - "1935:1935"
      - "8554:8554"
    volumes:
      - /srv/liodra/storage:/usr/share/nginx/html/storage
    environment:
      LOG_LEVEL: info
      MAX_DISK_USAGE: "80"
      MAX_ONDEMAND_PROCESSES: "32"
      # RTMP_SECRET: ganti-dengan-secret-anda

Upgrade

1. Tarik image versi baru.
2. Hentikan dan hapus container lama (docker rm -f liodra); rekaman dan konfigurasi aman di volume.
3. Jalankan kembali dengan perintah yang sama dan tag baru. Device dipulihkan dari recordings.yaml.
4. Periksa GET /api/v1/version dan CHANGELOG.md rilis untuk perubahan perilaku.

Troubleshooting

Selanjutnya