Launch a show format
Before you start
Section titled “Before you start”This walkthrough assumes a Norsk Manager with norsk-mgr in front of it on this machine, and one local server registered as a worker — the shape a first install leaves you with. Every command below runs against http://127.0.0.1:9333, the default; set NORSK_MGR_URL to point elsewhere.
Check the worker is online
Section titled “Check the worker is online”A local server is a machine you registered yourself; local-servers register gave you its node id. nodes get shows the Manager’s view of it: reachable, in a pool, with nothing placed on it yet.
norsk-mgr nodes get cluster-SME5vrXD+IM5BBwS{ "nodeId": "cluster-SME5vrXD+IM5BBwS", "state": "running", "lastActivityAt": "2026-11-21T11:12:30.455Z", "tags": { "pool": "local", "versionSkew": "none", "workerProtocolVersion": "2.3", "workerVersion": "0.1.0-2026-11-21-7114c45" }, "createdAt": "2026-11-21T11:12:27.748Z", "provider": { "provider": "cluster" }, "publicIpAddress": "127.0.0.1", "privateIpAddress": "127.0.0.1", "proxyUrl": "https://127.0.0.1", "providerInstanceId": "cluster-SME5vrXD+IM5BBwS", "spare": false, "unhealthy": false, "warmFor": [], "partiallyWarmFor": [], "inventory": { "totalCapacity": 8, "utilizationCap": 1, "totalCores": 8, "gpus": [], "capabilities": [ { "name": "norsk.io/intel-qsv", "count": 1 }, { "name": "norsk.io/job-socket", "count": 1 }, { "name": "norsk.io/secret-references", "count": 1 }, { "name": "norsk.io/secret-references-runtime", "count": 1 } ], "reservedCapacity": 0, "reservedCores": 0, "reservedCapabilities": [], "reachable": true, "lastSeen": "2026-11-21T11:12:30.494Z", "cordoned": false, "assignedRuntimes": [], "accessReplica": { "version": 1795259545037, "digest": "23dcc7b4cce0cf0e8b9542e452331d80f168b68e33efbadcfab0086e468ab1b3", "vouchedAt": "2026-11-21T11:12:30.040Z", "staleLimitMs": 28800000, "ageMs": 922, "state": "current" }, "secretsProfile": { "name": "production", "matchesManager": true } }}Register a product
Section titled “Register a product”A product is what you launch, e.g. Norsk Probe, Norsk Commentary or Norsk Studio. A released product is registered from its licence file with --license-file; here the product is a small example served from a development URL, so --dev-url is enough.
norsk-mgr product add --dev-url http://127.0.0.1:7418{ "product": { "name": "e2e-fixture", "spec": { "kind": "dev", "url": "http://127.0.0.1:7418" }, "addedAt": "2026-11-21T11:12:31.093Z", "running": true, "manifest": { "manifestSchemaVersion": 1, "name": "e2e-fixture", "version": "0.0.1", "api": { "basePath": "/", "proxyPaths": [], "openapiFragmentPath": "/openapi.json", "healthCheckPath": "/healthz" }, "ui": { "sidebarEntries": [], "dashboardWidgets": [], "productTemplateActions": [] }, "cli": { "subcommandTree": [] }, "targets": [ "docker-compose" ], "components": [], "runtime": { "sharedWorkingDirectory": false }, "defaultProductTemplates": [] } }, "warnings": []}The registry now knows the product by the name in its manifest, e2e-fixture.
Build a product template
Section titled “Build a product template”Describe the build
Section titled “Describe the build”A product template is one configured, launchable build of a product. The build request names the product, names the template, and carries the product’s own form values — none, for this example.
{ "name": "evening-news-studio", "productName": "e2e-fixture", "formValues": {}}Build and store it
Section titled “Build and store it”The Manager asks the product for its build and stores the result under the template name.
norsk-mgr product-template build build.json{ "name": "evening-news-studio", "revisionId": "8cc8fada-2758-4104-9bcc-d0d81900a170", "artifactSha256": "63edc1a4db7f7ad2bd92f827058565943658808c2732838f3603cea8ead9f747", "createdAt": "2026-11-21T11:12:31.258Z", "manifest": { "productTemplateSchemaVersion": 1, "productName": "e2e-fixture", "productVersion": "0.0.1", "target": "docker-compose", "generatedAt": "2026-11-21T11:12:31.252Z" }, "parameters": [ { "name": "INSTANCE_NAME", "purpose": "Compose project label for this instance", "type": "string" } ], "source": { "kind": "build", "productName": "e2e-fixture" }}norsk-mgr product-template list{ "items": [ { "name": "evening-news-studio", "revisionId": "8cc8fada-2758-4104-9bcc-d0d81900a170", "artifactSha256": "63edc1a4db7f7ad2bd92f827058565943658808c2732838f3603cea8ead9f747", "createdAt": "2026-11-21T11:12:31.258Z", "manifest": { "productTemplateSchemaVersion": 1, "productName": "e2e-fixture", "productVersion": "0.0.1", "target": "docker-compose", "generatedAt": "2026-11-21T11:12:31.252Z" }, "parameters": [ { "name": "INSTANCE_NAME", "purpose": "Compose project label for this instance", "type": "string" } ], "source": { "kind": "build", "productName": "e2e-fixture" }, "services": [ "media" ] } ]}Save the show format
Section titled “Save the show format”Write the format
Section titled “Write the format”A production template is a show format: the runtimes a production needs, which product template each one runs, and its parameters. You save it once and launch from it as often as you like. ${production} is resolved to each launched production’s own name, so two shows from the same format never collide.
{ "pool": "local", "runtimes": [ { "runtimeId": "main", "productTemplateName": "evening-news-studio", "parameters": { "INSTANCE_NAME": "${production}" } } ]}Save it under a name
Section titled “Save it under a name”norsk-mgr production-template save evening-news format.json{ "pool": "local", "runtimes": [ { "runtimeId": "main", "productTemplateName": "evening-news-studio", "parameters": { "INSTANCE_NAME": "${production}" } } ], "name": "evening-news", "createdAt": "2026-11-21T11:12:31.558Z", "updatedAt": "2026-11-21T11:12:31.558Z", "revision": 1}norsk-mgr production-template list{ "items": [ { "pool": "local", "runtimes": [ { "runtimeId": "main", "productTemplateName": "evening-news-studio", "parameters": { "INSTANCE_NAME": "${production}" } } ], "name": "evening-news", "createdAt": "2026-11-21T11:12:31.558Z", "updatedAt": "2026-11-21T11:12:31.558Z", "revision": 1 } ]}Launch it
Section titled “Launch it”Launch from the format
Section titled “Launch from the format”Launching creates a production and places its runtimes on a worker in the format’s pool. --production-id names the production; add --count N to launch several, numbered from that name.
norsk-mgr production-template launch evening-news --production-id evening-news-01{ "launched": [ { "productionId": "evening-news-01", "bundleId": "evening-news-01", "runtimes": [ "main" ], "launchCredential": "d2f5650ea226863fb7bbd3a32fa8e57733680e3279377bf29f2acf1646695323" } ], "failures": []}Watch it come up
Section titled “Watch it come up”production list shows every production with a rolled-up state: placing while a runtime is waiting for a worker, active once every runtime is running.
norsk-mgr production list{ "items": [ { "productionId": "evening-news-01", "pool": "local", "jobs": [ { "runtimeId": "main", "requirements": { "requiredCapacity": 1, "requiredCapabilities": [], "onRuntimeFailure": "avoidSpare" }, "launch": { "kind": "productTemplate", "ref": { "productName": "e2e-fixture", "productVersion": "0.0.1", "sha256": "63edc1a4db7f7ad2bd92f827058565943658808c2732838f3603cea8ead9f747", "templateName": "evening-news-studio", "source": { "kind": "url", "url": "http://127.0.0.1:9333/api/v1/product-templates/by-sha/63edc1a4db7f7ad2bd92f827058565943658808c2732838f3603cea8ead9f747/tar?token=…" } }, "parameters": { "INSTANCE_NAME": "evening-news-01" }, "startDateTime": "2026-11-21T11:12:31.777Z", "tags": { "launchCredentialSha256": "41a29095c39c1eee24a21ebd6f2c23149d81205efd25fb6b581c6fd4f4b2ba47", "productTemplateRevisionId": "8cc8fada-2758-4104-9bcc-d0d81900a170" } }, "startMode": "auto" } ], "state": "live", "rollupState": "active", "broken": false, "resilienceDegraded": false, "awaitingCapacity": false, "onLaunch": "avoidSpare", "identity": { "productionTemplateId": "evening-news", "productionTemplateRevision": "1", "runtimeUrlBase": "/bundles/evening-news-01" } } ], "nextCursor": null}production get has the full record — the format it came from, its runtimes, and the same rollupState.
norsk-mgr production get evening-news-01{ "productionId": "evening-news-01", "pool": "local", "jobs": [ { "runtimeId": "main", "requirements": { "requiredCapacity": 1, "requiredCapabilities": [], "onRuntimeFailure": "avoidSpare" }, "launch": { "kind": "productTemplate", "ref": { "productName": "e2e-fixture", "productVersion": "0.0.1", "sha256": "63edc1a4db7f7ad2bd92f827058565943658808c2732838f3603cea8ead9f747", "templateName": "evening-news-studio", "source": { "kind": "url", "url": "http://127.0.0.1:9333/api/v1/product-templates/by-sha/63edc1a4db7f7ad2bd92f827058565943658808c2732838f3603cea8ead9f747/tar?token=…" } }, "parameters": { "INSTANCE_NAME": "evening-news-01" }, "startDateTime": "2026-11-21T11:12:31.777Z", "tags": { "launchCredentialSha256": "41a29095c39c1eee24a21ebd6f2c23149d81205efd25fb6b581c6fd4f4b2ba47", "productTemplateRevisionId": "8cc8fada-2758-4104-9bcc-d0d81900a170" } }, "startMode": "auto" } ], "state": "live", "rollupState": "active", "broken": false, "resilienceDegraded": false, "awaitingCapacity": false, "onLaunch": "avoidSpare", "identity": { "productionTemplateId": "evening-news", "productionTemplateRevision": "1", "runtimeUrlBase": "/bundles/evening-news-01" }}Look at the runtime
Section titled “Look at the runtime”Each runtime is placed on one node. runtime get shows which, the product template it runs, and the history of where it has been.
norsk-mgr runtime get evening-news-01.0.main{ "job": { "runtimeRecordId": "evening-news-01.0.main", "state": "active", "currentHash": "97590907", "tags": { "auto-manager": "true", "productionId": "evening-news-01", "runtimeId": "main", "launchCredentialSha256": "41a29095c39c1eee24a21ebd6f2c23149d81205efd25fb6b581c6fd4f4b2ba47", "productTemplateRevisionId": "8cc8fada-2758-4104-9bcc-d0d81900a170", "replicaIndex": "0" }, "startDateTime": "2026-11-21T11:12:31.777Z", "cloud": "aws", "description": "", "writeFiles": [], "services": [], "volumes": [], "managerConfiguration": "", "norskMediaVersion": "recommended", "norskServiceParameters": { "portMappings": [], "environmentVariables": [], "cpuSet": [], "volumeMounts": [], "bindMounts": [], "ulimits": [] }, "shape": "", "availabilityDomain": "", "subnet": "", "architecture": "", "norskCpuList": [], "autoPlacement": { "$typeName": "norsk.api.manager.AutoPlacement", "requirements": { "$typeName": "norsk.api.manager.JobRequirements", "requiredCapacity": 1, "requiredCapabilities": [], "onRuntimeFailure": 1, "requiredHostPorts": [] } }, "productTemplate": { "productName": "e2e-fixture", "productVersion": "0.0.1", "sha256": "63edc1a4db7f7ad2bd92f827058565943658808c2732838f3603cea8ead9f747", "templateName": "evening-news-studio", "source": { "kind": "url", "url": "http://127.0.0.1:9333/api/v1/product-templates/by-sha/63edc1a4db7f7ad2bd92f827058565943658808c2732838f3603cea8ead9f747/tar?token=…" } }, "productTemplateParameters": { "INSTANCE_NAME": "evening-news-01" } }, "history": [ { "event": "running", "timestamp": "2026-11-21T11:12:36.908Z", "role": "primary", "nodeMetadata": { "nodeId": "cluster-SME5vrXD+IM5BBwS", "tags": { "pool": "local", "versionSkew": "none", "workerProtocolVersion": "2.3", "workerVersion": "0.1.0-2026-11-21-7114c45" }, "createdAt": "2026-11-21T11:12:27.748Z", "providerMetadata": { "provider": "cluster" } }, "runningNodeMetadata": { "publicDnsName": "", "privateDnsName": "127.0.0.1", "privateIpAddress": "127.0.0.1", "publicIpAddress": "127.0.0.1", "providerMetadata": { "provider": "cluster", "instanceId": "cluster-SME5vrXD+IM5BBwS" }, "proxyUrl": "https://127.0.0.1" } }, { "event": "provisioned", "timestamp": "2026-11-21T11:12:31.872Z", "role": "primary", "nodeMetadata": { "nodeId": "cluster-SME5vrXD+IM5BBwS", "tags": { "pool": "local", "versionSkew": "none", "workerProtocolVersion": "2.3", "workerVersion": "0.1.0-2026-11-21-7114c45" }, "createdAt": "2026-11-21T11:12:27.748Z", "providerMetadata": { "provider": "cluster" } }, "runningNodeMetadata": { "publicDnsName": "", "privateDnsName": "127.0.0.1", "privateIpAddress": "127.0.0.1", "publicIpAddress": "127.0.0.1", "providerMetadata": { "provider": "cluster", "instanceId": "cluster-SME5vrXD+IM5BBwS" }, "proxyUrl": "https://127.0.0.1" } }, { "event": "created", "timestamp": "2026-11-21T11:12:31.827Z" } ], "dropped": false, "dormant": false, "nodeId": "cluster-SME5vrXD+IM5BBwS", "nodeAddress": "127.0.0.1", "migration": { "declaredStrategy": "stopThenStart" }}Stop and clean up
Section titled “Stop and clean up”Stop the production
Section titled “Stop the production”Deleting a production stops its runtimes and frees the worker. The format is untouched — launch from it again tomorrow.
norsk-mgr production delete evening-news-01 --yes{ "productionId": "evening-news-01", "deleted": true}Remove the format and the template
Section titled “Remove the format and the template”Only if you are done with them: a format can be removed while productions launched from it are still running, a product template only once nothing references it.
norsk-mgr production-template rm evening-news{ "status": "ok", "name": "evening-news"}norsk-mgr product-template rm evening-news-studio --yes{ "status": "ok", "name": "evening-news-studio"}Captured 2026-11-21 against norsk-mgr 0.1.0-2026-11-21-7114c45, Norsk Manager 1.4.2-2026-11-19-3758b1eb — every command and screenshot on this page is from that run.