Skip to content

Launch a show format

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.

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.

Terminal window
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
}
}
}

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.

Terminal window
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.

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.

build.json
{
"name": "evening-news-studio",
"productName": "e2e-fixture",
"formValues": {}
}

The Manager asks the product for its build and stores the result under the template name.

Terminal window
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"
}
}
Terminal window
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"
]
}
]
}

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.

format.json
{
"pool": "local",
"runtimes": [
{
"runtimeId": "main",
"productTemplateName": "evening-news-studio",
"parameters": {
"INSTANCE_NAME": "${production}"
}
}
]
}
Terminal window
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
}
Terminal window
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
}
]
}

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.

Terminal window
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": []
}

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.

Terminal window
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.

Terminal window
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"
}
}

Each runtime is placed on one node. runtime get shows which, the product template it runs, and the history of where it has been.

Terminal window
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"
}
}

Deleting a production stops its runtimes and frees the worker. The format is untouched — launch from it again tomorrow.

Terminal window
norsk-mgr production delete evening-news-01 --yes
{
"productionId": "evening-news-01",
"deleted": true
}

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.

Terminal window
norsk-mgr production-template rm evening-news
{
"status": "ok",
"name": "evening-news"
}
Terminal window
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.