Jadpo is experimental and not ready for production. These docs follow the compiler's main branch as of 5 Nov 2026. What's built · Install 0.3.0
jadpo
ReferenceErrors

ErrorsTools · rule

configuration.value_missing

On this page

A setting config.jadpo declares without a default: has no value on this machine, in the environment or .env.local.

Area 14, Tools; not declinable; the next step is usually the human's.

Why Jadpo refuses it

A setting with no default: is one the app can't run without, such as a key a provider gave you. The app checks every setting before it serves anything, so it never answers a request half configured: jadpo config check reports the missing value, and jadpo dev stops before it starts.

Jadpo won't make a value up or ask your agent for one. Only you know the value, and a secret typed into a chat could end up in a log.

What it looks like

A project's config.jadpo declares a secret mail_api_key, and neither the environment nor .env.local sets it:

shell
jadpo config check
output
Values  mail_api_key  missing  MAIL_API_KEYerror: `MAIL_API_KEY` isn't set  reason: `mail_api_key` is required: it has no `default:`, so the app can't start without a value for it.  next: Run `jadpo config set mail_api_key` to store it in `.env.local`, or set `MAIL_API_KEY` in the environment (human)  rule: configuration.value_missing  help: https://jadpo.dev/docs/errors/configuration.value_missingconfig incomplete: 1 problem, 1 settingnext: jadpo config set mail_api_key  stores it in .env.local

(human) at the end of the next: line tells your coding agent to stop and ask you which fix you want, because the choice is yours to make: it decides where this machine's value comes from, and the value is one only you know.

jadpo dev checks the same values as it starts, and with this one it serves nothing: it shows the same error, then waits for a save that fixes it.

How to fix it

The question is where the value on this machine should come from.

If it should be kept in .env.local, run jadpo config set and type the value at its prompt, which hides it:

shell
jadpo config set mail_api_key
output
? Enter MAIL_API_KEY hiddenmail_api_key configured locally    variable   MAIL_API_KEY    file       .env.local    gitignore  added .env.local, so it isn't committed

The value is saved in .env.local, which git ignores, and jadpo dev starts with it.

If it comes from the environment, as on a server, set the variable the setting reads:

shell
MAIL_API_KEY=mk_test_51ab jadpo config check
output
Values  mail_api_key  set      MAIL_API_KEYconfig ready: 1 setting

The environment wins over .env.local. On a server, the variable is set in its environment or by its secret manager.

Markdown for agents: /docs/errors/configuration.value_missing.md.Built from Jadpo main at aee2e8f.