License
{"content":"Common issues around validating a Valdr license key and seeing the right subscription tier.\n\n{{\u003c callout type=\"info\" \u003e}}\nValdr can read a license key from `~/.valdr/valdr.lic`, and **Settings \u003e Settings** can validate and save a key for future launches. For most users, the Settings page is the right place to confirm the active license state.\n{{\u003c /callout \u003e}}\n\n## License status is unknown, invalid, or missing\n\n**Symptom:** **Settings \u003e Settings** shows no configured license, or the status is not valid.\n\n**Likely cause:** The key is missing, malformed, or has not been validated yet.\n\n**Fix:**\n\n1. Open **Settings \u003e Settings**\n2. Paste your license key into **License Key**\n3. Click **Validate \u0026 Save**\n4. Click **Refresh** or restart Valdr\n\nYou can also write the key before starting Valdr:\n\n```bash\nmkdir -p ~/.valdr\nprintf '%s\\n' \"YOUR_LICENSE_KEY_HERE\" \u003e ~/.valdr/valdr.lic\n```\n\n{{\u003c thumbcard src=\"/images/ui/settings/license-paste.png\" alt=\"Settings tab showing License key input with Validate \u0026 Save and Refresh buttons\" caption=\"Paste the key, click Validate \u0026 Save, then Refresh to confirm the current state\" \u003e}}\n\n## I upgraded but still see the old tier\n\n**Symptom:** You upgraded your subscription, but Valdr still shows the previous tier.\n\n**Likely cause:** The new key was not applied yet, or the running instance has not refreshed since the change.\n\n**Fix:**\n\n1. Open **Settings \u003e Settings**\n2. Paste the new key\n3. Click **Validate \u0026 Save**\n4. Click **Refresh** or restart Valdr\n\nIf you prefer the file-based flow, rewrite `~/.valdr/valdr.lic` with the new key and restart Valdr.\n\n{{\u003c callout type=\"tip\" \u003e}}\n**`raider` is a valid tier.** Treat it as a problem only if you expected `vanguard` or `sovereign`.\n{{\u003c /callout \u003e}}\n\n## License shows `invalid` or `error`\n\n**Symptom:** **Settings \u003e Settings** shows the license status as `invalid` or `error`.\n\n**Likely cause:** `invalid` usually means the key was rejected. `error` usually means validation could not complete, often because the running instance could not reach the license service.\n\n**Fix:**\n\n- Re-enter the key exactly as provided in your signup email\n- Make sure the machine running Valdr has internet access, then retry from **Settings \u003e Settings**\n- If the key is current and the error persists, contact support\n\n## Can't find my license key\n\n**Symptom:** You signed up but cannot locate the license email.\n\n**Fix:**\n\n- Search your inbox for Valdr or Project Viking\n- Check spam or junk folders\n- Contact support using the email address you used to sign up\n\n## Related\n\n- [Install Valdr \u003e Activate your license](/valdr/docs/getting-started/install/#activate-your-license)\n- [Pricing](/#pricing)","description":"Activation issues, tier mismatches, upgrades, and verifying that Valdr accepted your license.","title":"License"}
Common issues around validating a Valdr license key and seeing the right subscription tier.
Valdr can read a license key from
~/.valdr/valdr.lic, and Settings > Settings can validate and save a key for future launches. For most users, the Settings page is the right place to confirm the active license state.License status is unknown, invalid, or missing
Symptom: Settings > Settings shows no configured license, or the status is not valid.
Likely cause: The key is missing, malformed, or has not been validated yet.
Fix:
- Open Settings > Settings
- Paste your license key into License Key
- Click Validate & Save
- Click Refresh or restart Valdr
You can also write the key before starting Valdr:
mkdir -p ~/.valdr
printf '%s\n' "YOUR_LICENSE_KEY_HERE" > ~/.valdr/valdr.licPaste the key, click Validate & Save, then Refresh to confirm the current state
I upgraded but still see the old tier
Symptom: You upgraded your subscription, but Valdr still shows the previous tier.
Likely cause: The new key was not applied yet, or the running instance has not refreshed since the change.
Fix:
- Open Settings > Settings
- Paste the new key
- Click Validate & Save
- Click Refresh or restart Valdr
If you prefer the file-based flow, rewrite ~/.valdr/valdr.lic with the new key and restart Valdr.
raider is a valid tier. Treat it as a problem only if you expected vanguard or sovereign.License shows invalid or error
Symptom: Settings > Settings shows the license status as invalid or error.
Likely cause: invalid usually means the key was rejected. error usually means validation could not complete, often because the running instance could not reach the license service.
Fix:
- Re-enter the key exactly as provided in your signup email
- Make sure the machine running Valdr has internet access, then retry from Settings > Settings
- If the key is current and the error persists, contact support
Can’t find my license key
Symptom: You signed up but cannot locate the license email.
Fix:
- Search your inbox for Valdr or Project Viking
- Check spam or junk folders
- Contact support using the email address you used to sign up