Windmill (self-hosted)

Variables on your own Windmill instance, read back per key.

The connection

What	This provider
Vendor	Windmill
Key	`windmill-self-hosted-variables`
Availability	`available`. You can connect it today.
Credential penv holds	`windmill-self-hosted-token`
Values read back	yes
Activation	`immediate`

Direction	What it does
`import`	Reads names and values out of the store into penv.
`export`	Writes names and values from penv into the store.

immediate. The running app sees a new value at once.

Direction	Policies you can pick
`import`	`skip_existing`, `new_version`, `fail`
`export`	`create_only`, `overwrite`, `overwrite_and_prune`

How syncs work says what each one does.

You paste a credential you already hold. penv seals it and never shows it again.

Field	Label	Kind	Required	What it is
`token`	Token	secret, masked here and sealed	yes	Minted from your instance's account settings, and scoped to the workspace below.

Fixed when you connect, and shared by every mapping on it.

Field	Label	Kind	Required	Advanced	What it is
`host`	Instance URL	text	yes	no	Must be reachable from the internet for us to write to it.
`workspace`	Workspace	text	yes	no	The workspace ID from the Windmill URL. Its display name is a different value.

Answered once per environment you map.

Field	Label	Kind	Required	Advanced	What it is
`folder`	Folder	text	yes	no	penv writes under f/{folder}/. It never writes into a person's u/ namespace, and pruning deletes every variable in the folder, including ones this sync did not write.

penv probes for these when it verifies the connection.

Permission	Directions	Blocking	Without it
`workspace:read`	every direction	yes	Preview cannot list the workspace's variables.
`workspace:write`	`export`	yes	Export cannot create, change or remove a variable.