Offline with Ollama¶
This is the configuration that makes OpsPilot viable in an air-gapped environment. The model runs on the OpsPilot workstation, OpsPilot talks to it over loopback, and nothing about the session reaches the internet because there is nothing to reach it with. Pair it with a license that needs no network, and the workstation makes no outside connection at all.
Setting it up¶
- Install Ollama on the OpsPilot workstation.
- Pull a model — OpsPilot's in-app guidance suggests
ollama pull llama3.3. - In OpsPilot, choose Ollama (Local) and set the endpoint to
http://localhost:11434. - Pick the model and test.
The model picker for Ollama (Local) lists llama3.3, llama3.2,
codellama, mistral, phi4, gemma2, qwen2.5-coder, deepseek-r1 and
starcoder2. Pull the one you intend to select — Test Connection reads the
models Ollama actually has and tells you if the selected model is not among them,
along with what is.
Pull the exact tag you are going to select
Pull a tag the picker lists — llama3.3 rather than a shorter llama3, for
instance. Test Connection checks your selection against the models Ollama
actually has, so a near-miss on the tag is reported as the model not being found.
The endpoint field is the only credential Ollama needs — there is no API key.
http://localhost:11434 is Ollama's default; change it only if you have moved
Ollama's listener.
Licensing with no network¶
AI needs an active free trial or subscription, and the license has to work without a network too. The free trial makes no licensing connection. After you subscribe, choose one of these instead of online activation:
- Offline activation. In Settings → License, copy the request code, turn it into
a license file on any computer with internet (or have whoever manages your
organisation's licenses do it), and bring the
.opslicfile back with Import license file. Nothing on the workstation touches the network. - A deployment license. For sites where nothing may leave, IT installs one organisation-wide license file on every machine.
IT can also set "networkActivation": "disabled" in policy.json, so no user can
activate online by mistake. See Activate OpsPilot and
Licensing for IT.
Running with no egress¶
From that point, no terminal content, no command, no file and no metadata leaves the machine. The redaction layer still runs, but with a local model there is no egress for it to guard.
The interface ships every font and icon locally and references no external resources, so the whole application functions with no route to the internet. Settings, connections and profiles are local files; there is no account system and no telemetry, and licenses are checked on the workstation itself.
This is the only configuration the word air-gapped applies to: a local model, and offline activation or a deployment license. With any cloud provider the workstation still reaches the internet, which is private or VPN-only operation.
What to expect from a local model¶
A smaller local model is less precise at diagnosis than a large cloud model. A 7B or 8B model will sometimes propose a command that is close but not right, and sometimes miss a cause a larger model would find. That is the trade for running with no egress at all.
For most operational work it is still useful:
- reading a stack trace and saying which frame matters
- explaining a configuration error
- proposing the next diagnostic command
Those tasks dominate real triage, and a local model handles them well. Keep a larger cloud model for the hard ones: you can configure both and switch per session from the provider dropdown at the top of the AI panel, so a workstation that sometimes has connectivity is not tied to one choice.
Hardware¶
The model size you can run is set by the memory and GPU on the workstation rather than by OpsPilot. Size the workstation for the model you want, then point OpsPilot at it.
See also¶
- AI Providers — configuring and testing any provider
- Self-hosted & enterprise — a shared internal endpoint instead of a model on every workstation
- What gets sent — what the redaction layer guards when there is egress
- Activate OpsPilot — offline activation and license files