Skip to main content
By default the API is available only on the computer running Magnitude. Network access makes it available to other devices for inference, and lets you open the Magnitude app in a browser on another device. For a complete server setup, see Remote server.

​
Enable network access

​
Desktop Settings

  1. Open Settings → Network access and turn it on.
  2. Choose an Address. All interfaces serves every network this computer is on. Choosing one address serves only that network.
  3. Copy the API key. Other devices send it with every request.
  4. Copy the Reachable at URL.
  5. Restart Magnitude when the Restart required notice appears.
The first time the service listens on a network, macOS or Windows may ask whether to allow incoming connections. Allow them.

​
Configuration file

Without Desktop, add a network object to ~/.magnitude/config.json (%USERPROFILE%\.magnitude\config.json on Windows) with a long, randomly generated key, then restart Magnitude:
A server set up with magnitude server setup turns this on itself; see Remote server. All fields are documented in Configuration file.

​
Choose an address

Select that address in Settings or use it as network.bind. Use http://ADDRESS:10100/inference/v1 as the base URL. A private network can make the server reachable when you are away from home.

​
Open the app from another device

With network access on, open http://ADDRESS:10100 in a browser on the other device, using the same address as the base URL. Sign in with the API key. The app works as it does on the server: download and load models, watch usage, and change Settings. In a browser, Connections doesn’t change any computer’s agents itself: each agent has Copy setup prompt, which you paste into that agent, or any coding agent, on the computer you’re using.
  • A browser stays signed in until it goes 30 days unused. Settings → This browser → Sign out ends it sooner.
  • Browsers stay signed in when Magnitude restarts or updates. Changes to network settings apply when Magnitude restarts, so a regenerated key takes effect then and signs every browser out.
  • Turning network access off, regenerating the key, changing the address, or restarting from that browser asks first, because it disconnects the browser.
  • After five wrong keys, each further attempt waits longer, up to one minute.
The connection is plain HTTP. Use it on a network you trust or a private network such as Tailscale, or put an HTTPS reverse proxy in front of Magnitude and add its name to network.allowedHosts.

​
SSH tunnel

Keep Magnitude running on the server. On your own computer, run:
Use http://127.0.0.1:10101/inference/v1 in your client. SSH forwards that local port to Magnitude on the server. Network access can stay off, and no Magnitude API key is required through the tunnel. If your client requires a key, any value works. Through the tunnel, http://127.0.0.1:10101 also opens the app without signing in, because Magnitude sees the connection as coming from the server itself. Keep the tunnel running while using inference. You must be able to reach the server over SSH, for example through your local network or Tailscale.

​
Containers

From a container on this computer, use http://host.docker.internal:10100/inference/v1 with the API key. Network access must be on, because the container connects from its own address.

​
Windows with WSL

See Windows and WSL for mirrored and NAT networking.

​
Configure the app or agent

Use the server URL as the base URL and its API key as the key. For an app that is not a supported agent, the settings are the same as in Other agents with the network address in place of 127.0.0.1. Connections cannot configure a supported agent on another device, so write its configuration yourself. Each agent page shows the exact block under Configuration. Replace ADDRESS with the server address, API_KEY with the API key, and MODEL_ID with the model’s exact ID; take the context window and output limit from the model’s Details. Codex and Claude Code route hosted models through Magnitude’s gateway. From another device, only local models are available to them.

​
Check the connection

From the other device:
On Windows PowerShell, use curl.exe instead of curl. A model list means the connection works.

​
Custom hostnames

Magnitude accepts requests addressed to its IP addresses, localhost, host.docker.internal, and Tailscale MagicDNS names ending in .ts.net. To reach it by another name, such as a reverse proxy or a LAN hostname, list the name under network.allowedHosts in the configuration file.

​
Troubleshooting