Zero to Hero (Hybrid Mode, UI)

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-ui-OshAQ7/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>'

Getting started

Sign in

Navigate to the proxy URL. Unauthenticated requests are met with a sign-in form backed by the user you configured during init.

Enter your username and password and click Sign in.

Open the dashboard

Navigate to the Instances page

Click Instances in the sidebar to manage instances.

Launch an instance

The working directory auto-fills from your init settings.

View instance details

Click the instance card to see its full status.

Open Norsk Studio

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

Clean up

Navigate back to the Instances page, click the instance tile, then click Remove on the details page to delete it.

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 649902)