webapp.mk
Features

Configuration and secrets

Keep variables, secrets and feature flags out of your code. Your app fetches them when it starts, wherever it runs, and changes reach it without a redeploy.

Configuration and secrets

How it works

  1. Config in the panel
  2. A fetch key
  3. webappmk-client
  4. Your app starts with it
Reaches your app as

Environment

or a .env or JSON file

Changes arrive in

~30 seconds

while the client watches

Configs per plan

5 to 20

on every paid plan

Configuration and secrets

What a config holds

A config is a named set of values for one application. Edit it in the control panel, from the command line or through the API.

Variables

Plain keys and values, such as PORT or LOG_LEVEL.

Secrets

Stored encrypted and masked in the panel. A variable points at a secret by its key, so the value lives in one place.

Global variables

Values your account uses in many configs, such as a region or an API address. Change one and every config that points at it follows.

Feature flags

On and off switches your code reads, flipped without a deploy.

Log destinations

Attach a log destination and the client ships your app’s output there.

Import and export

Paste a .env or JSON to fill a config. Export it as .env, JSON or shell lines, or as a .qk-def file to commit next to your code.

Configuration and secrets

How your app gets it

webappmk-client is one small static binary for Linux. It reads three settings, fetches the config and starts your application.

Start your app through it

The client fetches the config and replaces itself with your application, which sees every value as an environment variable.

Or write a file

For software that only reads a .env or a JSON file.

Changes without a redeploy

Started with run or serve, the client checks for changes about every 30 seconds. With exec, a change arrives on the next start.

A key for each place

Make one fetch key for production, one for CI and so on. Each is shown once and stored hashed. Revoke one and the others keep working.

  • A key can carry an expiry
  • The client re-reads a key file, so a new key needs no restart
Configuration and secrets

Who it is for

Developers

One config for every environment, with secrets out of the repository.

Teams

Rotate a database password in one place and every app picks it up.

Self-hosters

Configure apps on your own servers or cluster from the same panel.

  • Environment variables
  • API keys and passwords
  • Feature flags
  • Shared settings
Configuration and secrets

Runs anywhere

The control panel shows these steps with your address, config name and key filled in, for a host, Docker, Compose and Kubernetes. Your image does not change.

Ho

Host

a server or a virtual machine
curl -fsSL <config-address>/v1/install.sh | sh
export WEBAPP_MK_URL=<config-address>
export WEBAPP_MK_INSTANCE=my-api
export WEBAPP_MK_SECRET=<fetch-key>
webappmk-client exec -- ./your-app
Fi

File

software that reads a .env
webappmk-client write --format dotenv --out .env

# or JSON
webappmk-client write --format json --out config.json
Do

Docker

any image, unchanged
docker run \
  -v webappmk-client:/wmk:ro \
  -e WEBAPP_MK_URL=<config-address> \
  -e WEBAPP_MK_INSTANCE=my-api \
  -e WEBAPP_MK_SECRET=<fetch-key> \
  --entrypoint /wmk/webappmk-client \
  your-image:tag exec -- ./your-app

Start with a free static site

Add resources when you need them.