Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.envless.cloud/llms.txt

Use this file to discover all available pages before exploring further.

​
MissingEnvlessFileError: no .envless found

The loader walked up from the current directory to the root without finding a .envless file. Fix: Run envless link in your project root.

​
NoAuthError: no cached key and no ENVLESS_TOKEN

You’re not logged in locally and no token is set. Fix: Either run envless login (dev) or set ENVLESS_TOKEN=ev_live_... (CI / production).

​
DecryptError: failed to decrypt bundle

Your cached key doesn’t match the current workspace passphrase — typically because someone rotated the passphrase. Fix: Run envless passphrase set to refresh the cached key.

​
MissingEnvError: env.X not found

You accessed env.X but X isn’t defined in the dashboard for the active environment. Fix:
  • Check the variable name for typos.
  • Confirm it exists in the right environment in the dashboard.
  • If it should be optional, mark it optional in the dashboard and regenerate types.

​
SchemaMismatchError

Your envless-env.d.ts is out of date — the dashboard schema changed. Fix: Run envless types and commit the result.

​
env.X is undefined instead of throwing

Something else populated process.env.X already (a real env var, a .env file, a platform injection). Real process.env wins by design. Fix: Unset the local override, or accept it — that’s the precedence rule.

​
”I’m getting server values in my client bundle”

The bundler plugin isn’t running. Check that:
  • Next: you wrapped your config with withEnvless.
  • Vite: the envless() plugin is in the plugins array.
  • You’re importing from @goenvless/envless/client (not /server) in client code.

​
”Hot reload doesn’t pick up dashboard changes”

You’re using the bare envless import without a framework adapter. The dev watcher only runs through the adapters. Fix: Switch to @goenvless/envless/next, @goenvless/envless/vite, or restart manually.

​
”Build fails in CI but works locally”

Local has a cached key in ~/.envless. CI doesn’t. Fix: Set ENVLESS_TOKEN in the CI environment.

​
”I rotated a variable but my running app still has the old value”

Production reads the cache once at boot. Variables are not auto-rotated at runtime by default. Fix: Restart the process, or call load({ revalidate: true }) from a signal handler.

​
Still stuck?

Open an issue at the Envless repo or reach support from the dashboard.