Deployment Guide

Deployment Guide

Deploying iond - Complete guide for deploying to production.

---

Overview

iond can be deployed as:

1. Standalone Backend - Full application with WebSocket support
2. Server Microservice - Lightweight REST API
3. Docker Container - Containerized deployment

---

Prerequisites

Requirement	Notes
Linux server	Ubuntu 22.04+ recommended
PostgreSQL 14+	For backend database
Nginx	Optional, for reverse proxy
Docker	Optional, for containerized deployment

---

Standalone Deployment

1. Prepare Server

# Update system
sudo apt update && sudo apt upgrade -y

# Install dependencies
sudo apt install -y postgresql postgresql-contrib nginx

# Create app user
sudo useradd -m -s /bin/bash iond

2. Setup Database

# Create PostgreSQL user and database
sudo -u postgres psql

CREATE USER iond WITH PASSWORD 'secure_password';
CREATE DATABASE iond OWNER iond;
GRANT ALL PRIVILEGES ON DATABASE iond TO iond;
\q

3. Deploy Binary

# Copy binary
sudo mkdir -p /opt/iond
sudo cp bin/iond /opt/iond/
sudo chown -R iond:iond /opt/iond

# Create storage directories
sudo mkdir -p /opt/iond/storage/{dbs,store,repos}
sudo chown -R iond:iond /opt/iond/storage

# Create environment file
sudo nano /opt/iond/.env

4. Environment Configuration

/opt/iond/.env

PORT=8000
DATABASE_URL=postgres://iond:secure_password@localhost:5432/iond?sslmode=disable
ENVIRONMENT=production
FLOW_DB_PATH=/opt/iond/storage/dbs
STORE_DB_PATH=/opt/iond/storage/store
REPO_PATH=/opt/iond/storage/repos

5. Systemd Service

/etc/systemd/system/iond.service

[Unit]
Description=iond Backend
After=network.target postgresql.service

[Service]
Type=simple
User=iond
WorkingDirectory=/opt/iond
EnvironmentFile=/opt/iond/.env
ExecStart=/opt/iond/iond
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

# Enable and start service
sudo systemctl daemon-reload
sudo systemctl enable iond
sudo systemctl start iond

# Check status
sudo systemctl status iond

6. Nginx Reverse Proxy

/etc/nginx/sites-available/iond

upstream iond {
    server 127.0.0.1:8000;
}

server {
    listen 80;
    server_name flow.example.com;

    location / {
        proxy_pass http://iond;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

# Enable site
sudo ln -s /etc/nginx/sites-available/iond /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

---

Docker Deployment

Docker Compose

docker-compose.yml

version: '3.8'

services:
  iond:
    image: iond:latest
    build: .
    ports:
      - "8000:8000"
    environment:
      - PORT=8000
      - DATABASE_URL=postgres://iond:password@db:5432/iond?sslmode=disable
      - ENVIRONMENT=production
    volumes:
      - ./storage:/app/storage
    depends_on:
      - db
    restart: unless-stopped

  db:
    image: postgres:14-alpine
    environment:
      - POSTGRES_USER=iond
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=iond
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres_data:

# Deploy
docker-compose up -d

# View logs
docker-compose logs -f iond

---

Server Microservice Deployment

For lightweight deployments:

# Deploy server only
sudo mkdir -p /opt/flow-server
sudo cp bin/flow-server /opt/flow-server/
sudo mkdir -p /opt/flow-server/storage

# Systemd service
# /etc/systemd/system/flow-server.service
[Unit]
Description=iond Server
After=network.target

[Service]
Type=simple
ExecStart=/opt/flow-server/flow-server -port 8080 -path /opt/flow-server/storage
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

---

SSL/TLS Setup

Let’s Encrypt with Certbot

# Install certbot
sudo apt install certbot python3-certbot-nginx

# Get certificate
sudo certbot --nginx -d flow.example.com

# Auto-renewal
sudo systemctl enable certbot.timer

---

Monitoring

Health Check

# Add health endpoint check
curl http://localhost:8000/health

Logging

# View logs
sudo journalctl -u iond -f

# Docker logs
docker logs -f iond

Process Monitoring

# Using htop
htop -p $(pgrep iond)

# Memory usage
ps aux | grep iond

---

Backup Strategy

Database Backup

/opt/iond/scripts/backup.sh

#!/bin/bash
DATE=$(date +%Y%m%d_%H%M%S)
BACKUP_DIR=/opt/iond/backups

# PostgreSQL backup
pg_dump -U iond iond > ${BACKUP_DIR}/db_${DATE}.sql

# SQLite backups
cp -r /opt/iond/storage/dbs ${BACKUP_DIR}/dbs_${DATE}

# Cleanup old backups (keep 7 days)
find ${BACKUP_DIR} -mtime +7 -delete

Cron Job

# Daily backup at 2am
0 2 * * * /opt/iond/scripts/backup.sh

---

Scaling

Horizontal Scaling

For multiple instances:

• Use PostgreSQL for shared state
• Use Redis for session management
• Use load balancer for distribution

Load Balancer Configuration

upstream iond_cluster {
    server 10.0.0.1:8000;
    server 10.0.0.2:8000;
    server 10.0.0.3:8000;
}

server {
    listen 80;
    server_name flow.example.com;

    location / {
        proxy_pass http://iond_cluster;
        # ... other proxy settings
    }
}

---

Security Checklist

• Use HTTPS with valid SSL certificate
• Configure firewall (UFW/iptables)
• Use strong database passwords
• Restrict database access to localhost
• Regular security updates
• Log monitoring
• Backup verification

---

Troubleshooting

Service Won’t Start

# Check logs
sudo journalctl -u iond -n 50

# Check permissions
ls -la /opt/iond/

# Test manually
sudo -u iond /opt/iond/iond

Database Connection Issues

# Test PostgreSQL connection
psql -h localhost -U iond -d iond

# Check PostgreSQL status
sudo systemctl status postgresql

Port Conflicts

# Check port usage
sudo lsof -i :8000
sudo netstat -tlnp | grep 8000

---

Related Documentation

• Development Guide - Development setup
• Building Guide - Build process
• Architecture - System overview