Single Server

The simplest deployment: everything on one server.

Setup

npm install -g @mediagato/modelreins
modelreins init --mode server

Start the coordinator

modelreins coordinator start --port 7420

Start workers on the same machine

# Local provider worker
modelreins worker start --name local-worker --provider ollama

# Cloud provider worker
ANTHROPIC_API_KEY=sk-ant-... modelreins worker start --name cloud-worker --provider claude

Systemd service (Linux)

modelreins service install --coordinator
modelreins service install --worker local-worker --provider ollama

This creates systemd units that start on boot and restart on failure.

Reverse proxy

Put the dashboard behind nginx with HTTPS:

server {
    listen 443 ssl;
    server_name modelreins.example.com;

    ssl_certificate /etc/ssl/certs/modelreins.pem;
    ssl_certificate_key /etc/ssl/private/modelreins.key;

    location / {
        proxy_pass http://localhost:7420;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
    }
}

Docker

docker compose up -d

See the docker-compose.yml in the repository for a complete single-server setup.