Skip to main content

Docker Deployment

Deploy Steward with Docker Compose for a production-ready setup with PostgreSQL, the Steward API, and the proxy gateway.

Docker Compose

Create a docker-compose.yml:

Environment File

Create a .env file:

Start

Database Migrations

Run migrations after the first start:

Adding Agent Containers

To run agent containers alongside Steward on the same Docker network:

Network Isolation

For maximum security, create a separate network where agent containers can only reach the Steward proxy:
With network isolation, agents cannot make any network requests except to the Steward proxy. The proxy handles all outbound traffic, injecting credentials and enforcing policies.

Updating

Backup

Always back up your database before updates. The database contains encrypted keys — if lost, all agent wallets are inaccessible.