Cloud Quick Start

# Create system group and user
sudo groupadd --system bintrail 2>/dev/null || true
sudo useradd --system --no-create-home --shell /usr/sbin/nologin -g bintrail bintrail 2>/dev/null || true
id bintrail  # verify: should show uid/gid for bintrail

# Create environment file (replace all placeholders)
sudo mkdir -p /etc/bintrail
sudo tee /etc/bintrail/agent.env > /dev/null <<'EOF'
BINTRAIL_API_KEY=bt_live_YOUR_API_KEY
BINTRAIL_ENDPOINT=wss://api.dbtrail.com/v1/agent
BINTRAIL_SOURCE_DSN=bintrail:YOUR_PASSWORD@tcp(YOUR_MYSQL_HOST:3306)/
BINTRAIL_SERVER_ID=99996
# Schemas to monitor (optional — defaults to all user schemas)
# BINTRAIL_SCHEMAS=myapp,analytics
# S3 for Parquet archives (REQUIRED — agent refuses to start without it)
BINTRAIL_S3_BUCKET=my-company-dbtrail
BINTRAIL_S3_REGION=us-west-2
EOF
sudo chown root:bintrail /etc/bintrail/agent.env
sudo chmod 640 /etc/bintrail/agent.env

sudo tee /etc/systemd/system/bintrail-agent.service > /dev/null <<'EOF'
[Unit]
Description=Bintrail Agent
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=bintrail
Group=bintrail
EnvironmentFile=/etc/bintrail/agent.env
ExecStart=/usr/local/bin/bintrail agent \
  --api-key ${BINTRAIL_API_KEY} \
  --endpoint ${BINTRAIL_ENDPOINT} \
  --server-id ${BINTRAIL_SERVER_ID} \
  --source-dsn "${BINTRAIL_SOURCE_DSN}" \
  --schemas ${BINTRAIL_SCHEMAS} \
  --s3-bucket ${BINTRAIL_S3_BUCKET} \
  --s3-region ${BINTRAIL_S3_REGION}
Restart=always
RestartSec=5
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable --now bintrail-agent

# Check agent is running
sudo systemctl status bintrail-agent

# Follow the agent logs
sudo journalctl -u bintrail-agent -f