For the complete documentation index, see llms.txt. This page is also available as Markdown.

Nokia SR Linux

NoPorts as a native feature of the Nokia SR Linux network OS

NoPorts runs on Nokia SR Linux routers as a native application, built with the SR Linux NetOps Development Kit (NDK) and listed in Nokia's official NDK App Catalog. Unlike a generic Linux install, everything is managed the way router operators expect:

  • Configuration lives in the router's own config tree (CLI, gNMI, or JSON-RPC) with candidate/commit/rollback semantics — no env files, no hand-managed daemons

  • Operational state (oper-state, PID, daemon version) is published into the state tree and streams over gNMI telemetry

  • Device keys are cut on the router with APKAM enrollment — no atKeys files are ever copied to the device

  • The daemon runs in the management VRF and is supervised (restarted, reconfigured on commit) by the NDK agent

Source, releases and full documentation: atsign-foundation/noports-srlinux.

Requirements

  • SR Linux 24.3.1 or later (Debian-based releases); amd64 or arm64

  • Two Atsigns: one for the router, one for the operator — see noports.com

  • The NoPorts client installed on your machine (see Client Installation)

No router hardware? The repo quickstart includes two free virtual labs using Nokia's public SR Linux container image: a containerlab topology, and a standalone plain-Docker variant that runs natively on Apple Silicon.

Install

Download the .deb (amd64 and arm64) from the releases page, copy it to the router, then from the SR Linux CLI drop to the shell with bash:

sudo dpkg -i noports-srlinux_*.deb   # postinstall reloads app_mgr

Configure from the SR Linux CLI

Check what the agent thinks:

Until the router is onboarded it reports oper-state awaiting-onboarding. The full command surface — policy Atsigns for fleet-scale access control, device groups, permit-open lists for npt, sshd options — is documented in the repo's CLI reference.

Onboard the router (APKAM)

Enrollment cuts new, scope-limited APKAM keys on the router itself, using a one-time passcode; the device Atsign's full keys never leave your custody.

On your machine:

On the router (bash shell):

While it waits, approve from your machine:

The agent detects the new keys within about 15 seconds and starts the daemon — info from state / noports state shows oper-state running.

Connect

You can also tunnel gNMI (or NETCONF/JSON-RPC) without SSH — add the port to the permit-open list first (set / noports access permit-open [ localhost:22 localhost:57400 ]):

Networks that only allow outbound 443

Management VRFs are often restricted to well-known outbound ports. Both sides of NoPorts can be pinned to 443 — this exact combination is verified end-to-end on SR Linux:

On the router (before onboarding, so enrollment uses it too):

On the client, add --443 so the relay data path also uses 443:

NoPorts device packages also exist for Cisco IOS-XE app hosting (noports-iosxe) and Junos OS Evolved containers (noports-junos-evolved).

Last updated