M3 Forge Documentation
Documentation for M3 Forge - Workflow automation platform for document processing.
M3 Forge requires external PostgreSQL and MinIO services. Configure DATABASE_URL and S3 settings in .env.
Quick Start
All-in-One Docker
Simplest setup - everything in one container
Docker Compose
Production deployment with individual services
Local Development
Full development environment
All-in-One Docker
The simplest way to get started — a single container with everything bundled:
docker run -d --name m3-forge \
-p 3000:3000 \
-v /var/run/docker.sock:/var/run/docker.sock \
-e DATABASE_URL=postgresql://postgres:123456@host.docker.internal:5432/studio \
-e S3_ENDPOINT_URL=http://host.docker.internal:8000 \
-e S3_ACCESS_KEY_ID=MARIEACCESSKEY \
-e S3_SECRET_ACCESS_KEY=MARIESECRETACCESSKEY \
-e JWT_ACCESS_SECRET=$(openssl rand -hex 32) \
-e JWT_REFRESH_SECRET=$(openssl rand -hex 32) \
marieai/m3-forge-all-in-one:latest
# Access at http://localhost:3000See All-in-One Deployment for full configuration options.
Docker Compose
For production deployments with individually scalable services. See Docker Compose Deployment for the full docker-compose.yml, environment setup, and configuration profiles.
Local Development
For active development:
# Install dependencies
pnpm install
# Configure DATABASE_URL and S3 settings in .env
# Run development servers
pnpm devUseful Commands
| Category | Command | Description |
|---|---|---|
| All-in-One | docker run ... marieai/m3-forge-all-in-one | Start container |
| All-in-One | docker stop m3-forge | Stop container |
| All-in-One | docker logs -f m3-forge | View logs |
| Docker Compose | docker compose --profile production up -d | Start production |
| Docker Compose | docker compose down | Stop all services |
| Docker Compose | docker compose logs -f | View all logs |
| Database | docker exec m3-forge npx prisma migrate deploy ... | Run migrations |
Next Steps
Last updated on