How Dopbase works

How Dopbase works for people, machines, and AI agents

Dopbase is a self-hosted, open-source secrets manager. People manage application secrets, machines load one environment at runtime, and AI agents can inspect project structure without seeing secret values.

Human
Machine
AI agent

Runtime delivery

From the Dopbase server to your application

When the server is available, the CLI authenticates, retrieves one environment, and starts your application with those values in process memory. It does not write a shared .env file.

A developer runs the Dopbase CLI, which fetches an environment from the encrypted Dopbase server and injects its secrets into an application process.

Swipe to view the full diagram.

The server stores encrypted values and audit history. The CLI delivers the selected environment to the child process without creating a shared environment file.

Access by identity

Choose the identity that matches the job

A teammate, a deployment, and a coding agent should not share the same credential or permissions.

Human

People manage secrets

Use the Admin UI for day-to-day editing or sign in through the CLI for terminal work. Human accounts can create projects, separate environments, update secrets, and create runner tokens.

Root and admin accounts can also manage human users and AI accounts.

Typical access

Manage projects, environments, secrets, and runner tokens.

Machine

Machines run applications

CI jobs, servers, containers, and deployment tools use a runner token tied to one environment. dopbase run loads that environment and starts the application with the values in memory.

export DOPBASE_TOKEN=<runner-token>
dopbase run env_01ABCDEF -- ./payment-service
Restricted to

One environment. It cannot change or export secrets.

AI agent

Agents read structure, not values

Give a coding agent a named service account when it needs to understand the project setup. It can read projects, environments, secret names, versions, and timestamps.

It cannot retrieve secret values, change data, list runner tokens, or read audit history.

Metadata only

Secret values stay outside the agent's access.

Run it yourself

Set up Dopbase on your own infrastructure.

One executable contains the server, Admin UI, REST API, migrations, and command-line client.