Skip to content

Remote browser access ​

klars serve runs the workspace without a desktop window. Connect from a browser while Python, project files, and terminal commands stay on the service machine.

Provisioning

These instructions assume you already have a provisioned klars serve installation. A public headless archive download is not linked here yet. Node.js 22.13+ and a suitable Python environment are prerequisites.

Start the service ​

On the machine holding your model:

sh
export KLARS_PYTHON=/absolute/path/to/your/env/bin/python
klars serve --port 4317

The default listener is 127.0.0.1. The CLI prints a one-time browser URL to its controlling terminal. It does not launch a browser on the remote machine.

Forward the port ​

From your laptop, keep an SSH tunnel open:

sh
ssh -N -L 4317:127.0.0.1:4317 user@your-server

Open the printed one-time URL in your laptop’s browser. If you selected another service port, use that port in the forward as well.

Owner access

The one-time URL grants owner access, including the project shell on the service machine. Keep it private. It expires and can be consumed once; restart serve to obtain another URL.

Use the workspace ​

Folder paths are paths on the service machine. Select its Python environment, open its model project, and use the same graph, chat, and experiment views as desktop.

With the default data directory, a same-user Python tracker on that machine can discover the service automatically. A custom --data-dir intentionally isolates discovery; pass the tracker’s address and credential explicitly.

Direct HTTPS access ​

SSH forwarding is the simplest setup. For a direct remote listener, you must explicitly provide a bind address, public HTTPS origin, TLS certificate, and private key:

sh
klars serve --host 0.0.0.0 --port 4317   --public-origin https://ml.example.com:4317   --tls-cert /absolute/path/cert.pem   --tls-key /absolute/path/key.pem

Use a browser-trusted certificate and restrict network access to trusted clients. Only the literal 127.0.0.1 selects loopback mode; localhost and ::1 also require the explicit TLS options.

Direct remote mode uses the terminal’s owner handoff; pairing-code redemption is disabled there. Remote MCP OAuth is not supported.

Stop cleanly ​

Press Ctrl C in the serving terminal. klars closes listeners and removes its discovery record and owned lock. See the CLI reference for all supported options.

Your models. Your machine. Your next idea.