Zero to Hero (Hybrid Mode, CLI)

First installation

Initialise norsk-ctl

Run norsk-ctl init to create the configuration file. Hybrid mode puts studio on the Docker bridge (proxied) and media on the host network for low-latency ingest.

$ norsk-ctl init --network-mode hybrid --license-file /home/parallels/internal_dev_license.json --working-directory /tmp/workspace --proxy-user admin --proxy-password testpass1

Proxy user "admin" created
Config written to /tmp/nix-shell.DOxv4h/norsk-ctl-guide-zero-to-hero-hybrid-cli-PB9mLK/config.yaml
Equivalent command: norsk-ctl init --network-mode hybrid --license-file /home/parallels/internal_dev_license.json --working-directory /tmp/workspace --proxy-user admin --proxy-password '<redacted>'

Launch an instance

$ norsk-ctl instance launch my-studio --hardware none --working-directory /tmp/workspace

Instance launched

Check instance status

$ norsk-ctl instance list

instances:
  - id: my-studio
    name: norsk-studio
    port: 8001
    workflow: ""
    status: healthy
    uptime: 12 seconds ago
    studioTag: 1.27.0-2026-05-08-d0e01eea
    studioImage: norskvideo/norsk-studio
    media:
      name: norsk-inst-my-studio-media
      image: norskvideo/norsk
      tag: 1.0.402-2026-05-08-5d5644d3
      status: healthy
      uptime: 12 seconds ago
proxy:
  name: norsk-proxy-guide-hybrid-cli-oauth2
  image: quay.io/oauth2-proxy/oauth2-proxy
  tag: v7.15.1-alpine
  status: running
  uptime: 14 seconds ago
runMode: standard

$ norsk-ctl instance describe my-studio

id: my-studio
name: norsk-studio
port: 8001
workflow: ""
status: healthy
uptime: 12 seconds ago
studioTag: 1.27.0-2026-05-08-d0e01eea
studioImage: norskvideo/norsk-studio
media:
  name: norsk-inst-my-studio-media
  image: norskvideo/norsk
  tag: 1.0.402-2026-05-08-5d5644d3
  status: healthy
  uptime: 12 seconds ago
studioUrl: http://localhost/instance/my-studio/studio/
visualiserUrl: http://localhost/instance/my-studio/visualiser/
configDirectory: /tmp/nix-shell.DOxv4h/norsk-ctl-guide-zero-to-hero-hybrid-cli-PB9mLK/instances/my-studio
workingDirectory: /tmp/workspace
logsDirectory: /tmp/nix-shell.DOxv4h/norsk-ctl-guide-zero-to-hero-hybrid-cli-PB9mLK/log/instances/my-studio

Open Norsk Studio

In hybrid mode, the studio is accessed through the proxy — just like Docker mode.

Clean up

Delete the instance to stop its containers and free resources.

$ norsk-ctl instance delete my-studio

Instance my-studio removed

The proxy is needed whenever instances are running — with no instances left, it can be stopped to free the port.

$ norsk-ctl proxy stop

The daemon can be stopped and restarted at any time — running instances and the proxy are unaffected.

$ norsk-ctl shutdown --daemon-only

Daemon stopped (pid 646303)