Deploy Containers Without the Complexity

FlatRun is a lightweight, file-based container and system deployment manager. Manage Docker apps, services, and infrastructure without databases or complex orchestration.

$ flatrun-agent --config config.yml
Starting FlatRun Agent v1.0.0
API server running on :8090
Monitoring /opt/flatrun/deployments
✓ Ready to manage deployments

Why FlatRun?

📁

File-Based Architecture

No database required. Everything is stored as files on your filesystem—easy to backup, version control, and understand.

🐳

Container Native

Works directly with Docker Compose and container orchestration. No proprietary formats or lock-in.

🚀

Quick App Templates

Deploy popular applications and services in seconds with pre-configured templates.

📊

Real-Time Monitoring

Monitor system health, container resources, and logs from a single dashboard.

🔒

SSL Certificate Tracking

Keep track of your SSL certificates and get alerted before they expire.

Lightweight & Fast

Single Go binary with minimal resource footprint. Starts in milliseconds.

How It Works

1

Install the Agent

Download the FlatRun agent binary and configure it for your server.

2

Add Your Deployments

Create directories with configuration files in your deployments folder.

3

Manage via UI

Use the web dashboard to start, stop, and monitor your infrastructure.

Get Started in Minutes

Installation
# Clone and build the agent
git clone https://github.com/flatrun/agent.git
cd agent
make build

# Configure
cp config.example.yml config.yml
nano config.yml

# Run
./flatrun-agent --config config.yml