Bitwarden Secrets Manager¶
Configure Bitwarden Secrets Manager as a remote secrets provider. ComposeFlux fetches every secret in the configured project and exposes each value under its secret key name.
1. Create a project¶
- Sign in to Bitwarden.
- Open Secrets Manager.
- Click New Project and create a project for ComposeFlux.

2. Add secrets¶
Add the keys referenced by the stacks, for example DATABASE_URL or API_KEY.
To fetch the Git deploy key from Bitwarden, create a secret that contains the private key and copy its secret ID. See Store the key in a secrets manager.

3. Create a machine account¶
- Open the Machine Accounts tab.
- Click New Machine Account.
- Assign the project created above.
- Set the permission to Can read.
- Click Save.

4. Create an access token¶
- Open the machine account.
- Open the Access tokens tab.
- Click Create access token.
- Copy the token and store it securely.

5. Configure ComposeFlux¶
Set the following values. The organization ID, project ID, API URL, and identity URL are shown in the machine account configuration.

BITWARDEN_ACCESS_TOKEN=<access-token>
BITWARDEN_ORGANIZATION_ID=<organization-id>
BITWARDEN_PROJECT_ID=<project-id>
# Optional: only when fetching the SSH deploy key from Bitwarden
GIT_DEPLOY_KEY_SECRET_REF=<secret-id>
# Optional: only for the EU cloud or self-hosted Bitwarden
# BITWARDEN_API_URL=https://vault.bitwarden.eu/api
# BITWARDEN_IDENTITY_URL=https://vault.bitwarden.eu/identity
Use the values¶
Reference the keys in a stack's Compose file:
Keys that are not referenced are not passed to containers. After changing a secret in Bitwarden, run
composeflux sync to apply it.