Repository navigation
v26.10.2 — safer configuration: env variables are enforced, dead keys are reported, and the docs match the code
LatestUpgrade notes — four changes can stop an existing config from starting
server:block is an error. flAPI never read it. Usehttp-port/http-host,--port/--host, orFLAPI_PORT/FLAPI_HOST.template.environment-whitelistis now enforced for YAML files. An unlisted{{env.NAME}}stops startup and names the variable. An empty or missing whitelist allows none. A top-levelenvironment-whitelist:is an error; it belongs undertemplate:.- Included files are covered too.
{{env.NAME}}inside an{{include}}d file is now substituted and checked. Anauth.usersentry with an empty username or password stops startup. - Spaced references are substituted.
{{ env.NAME }}in YAML now works instead of staying literal.${NAME}is still not supported.
Added
- Unknown top-level keys in
flapi.yamlnow log a warning, with hints for near-misses such asrate-limitvsrate_limitandhttpsvsenforce-https. flapi packvalidates the config first and writes no bundle if it is invalid (--skip-validationopts out).
Fixed
--validate-configaccepts MCP prompt files, and every shipped example now validates.- The config dump shown when a config fails to load no longer prints passwords from the environment.
GET /api/v1/_config/environment-variableslists the variables that match whitelist patterns.flapi_create_endpointnow saves the endpoint, acceptstemplate-sourceandconnection, and the endpoint serves and survives a restart.flapi_delete_endpointremoves the endpoint's YAML file.flapii project initgenerates a config flAPI actually reads.- Three
mcp.*settings that did nothing now warn that they are ignored. - Docs and examples no longer show
${VAR}or a top-levelhttps:block, neither of which flAPI reads.
Docker
:latest now points to the latest release.