What the error messages mean
Every message below is one GNexusOS can actually show you. Find yours, and this page tells you what it means and what to do.
"Agents are not running"
This is the big one, so it comes first.
It means GNexusOS has not been able to confirm your licence, so it has paused your agents. The screen explains which check is missing.
Your work is safe. The app says so itself, and it is worth repeating:
Your workspace, transcripts and files are untouched and still yours, and you can still export them.
Nothing is deleted and nothing is locked away. Only the agents stop.
What to do: get the machine online and open GNexusOS. It checks every time it starts, so in almost every case that is enough.
If it will not clear, see the last section of this page.
Messages about your licence key
These appear when you paste a key into Settings then Licence.
"That does not look like a GNexusOS licence key"
The text you pasted is not the right shape. Usually something was missed when copying, or a line break crept in from an email.
Copy it again from the original email, making sure you get all of it.
"This licence key could not be checked"
The key is the right shape but failed verification, which again usually means a character was altered or lost in copying. Some email programs break long strings of text across lines.
Copy it straight from the original email rather than a forwarded copy.
"This licence key is in an older format that GNexusOS no longer accepts. Request a new key."
An old key from before a change to the format. Write to [email protected] from the address you bought with and ask for a new one.
"This licence key is newer than this version of GNexusOS understands. Update the app, then try again."
Your key is fine. The app is out of date. Update GNexusOS and paste it again.
"This licence key does not carry a usable validity date"
You may also see this about an issue date or a seat count. The key is damaged, and trying again will not help. Ask for a replacement at [email protected].
"The licence file could not be read"
GNexusOS could not read its own stored licence. This usually means a file permission problem, or a workspace folder that has moved. Paste your key again to write a fresh copy.
"No agent can be hired because this workspace has no valid licence"
You are trying to create an agent before adding a licence. Go to Settings then Licence and add your key.
Note that each workspace needs its own licence. A second workspace does not inherit the first one's.
Messages about AI providers
"provider unavailable" with Ollama
Ollama is not running on your machine. Start it, check it has the model you named, and try again.
You may see this as "KEY REJECTED BY OLLAMA (LOCAL): provider unavailable". Ignore the "key rejected" part, because Ollama does not use a key at all. The real problem is that it is not running.
A rejected API key
Check these in order, because they are the common causes:
- A copying mistake. A missing character, or a space at either end.
- Billing is not set up. Several providers issue a key that does nothing until you add a payment method.
- The key was revoked or expired in your provider account.
- The wrong provider is selected. An OpenAI key will not work when the dropdown says Anthropic.
"Connect your first AI provider to get started"
GNexusOS needs at least one provider before it will do anything. This is not a warning you can dismiss or skip past.
If you choose a provider that needs no key, such as Ollama, the key box disappears, but the sentence above it may still mention a key. You can ignore that. It is a wording slip, not an instruction.
Messages about pairing a machine
The code has expired
A pairing code lasts fifteen minutes. Start pairing again in the app and a fresh one appears. The old one is dead and cannot be revived.
The code is not accepted
- Check you are reading it correctly. The alphabet avoids most lookalike characters, but it is worth a second glance.
- Capitals, spaces and the hyphen do not matter. The page ignores them.
- Use the code on screen now, not one from an earlier attempt.
The machine is already paired
It is attached to an account already. If that account is yours, you do not need to pair again. If you are moving the machine to a different account, remove it from the old one first on the Machines page.
When the app cannot reach us
GNexusOS checks your licence with our service from time to time. Being unable to reach us does not stop your software. An outage at our end, a flight, a hotel network: none of these stop your agents.
The only answer that stops anything is a definitive one saying the licence was revoked. Everything else, including a timeout, an error, or no connection at all, means "could not check", and the app carries on.
If a check is missed while you are offline, the app asks you to connect to finish activating, and resolves itself as soon as you are back online. The Terms of Service state this as a commitment, not a courtesy.
When agents stop and connecting does not help
If the app says agents are not running and getting online does not clear it, one of these is true.
The licence was refunded or charged back. A refund revokes the licence, and that is what the refund pays for. The Refund Policy sets out what is covered.
The licence was revoked for another reason. Write to [email protected] from the address you bought with and ask why.
The licence service no longer exists. If GNexusOS is ever retired, a signed sunset declaration is published. Paste it on the same screen that reports the problem, and the app stops asking for the check for good, with no network needed. That paste field is deliberately placed on the screen you would be stuck on.
A sunset declaration does not revive a licence that was genuinely revoked, and it is not a licence on its own.
Still stuck
Write to [email protected] from the address you bought with, and say what the screen shows. Copy the wording exactly, because it tells us which of the cases above you are in.
Never send anyone your licence key or an API key, including us. We can find your licence from your email address alone.
