Deployment Guide

This guide covers deployment options and configurations for self-hosted Tiptree Platform installations.

Docker Deployment

Prerequisites

• Docker Engine 20.10+
• Docker Compose 2.0+
• 4GB RAM minimum
• 20GB storage minimum

Basic Deployment

1. Clone the repository:

git clone https://github.com/tiptreesystems/platform
cd platform

2. Configure environment:

cp .env.example .env
# Edit .env with your configuration

3. Start the services:

docker compose up -d

Production Configuration

For production deployments, consider these additional steps:

1. Use a reverse proxy (e.g., Nginx)
2. Enable SSL/TLS
3. Configure monitoring
4. Set up backups

Example Nginx configuration:

server {
    listen 443 ssl;
    server_name platform.yourdomain.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://localhost:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

Kubernetes Deployment

Prerequisites

• Kubernetes 1.22+
• Helm 3.0+
• kubectl configured

Installation

1. Add Helm repository:

helm repo add tiptree https://charts.tiptreesystems.com
helm repo update

2. Create values file:

values.yaml

platform:
  replicas: 3
  resources:
    requests:
      memory: "1Gi"
      cpu: "500m"
    limits:
      memory: "2Gi"
      cpu: "1000m"

3. Install chart:

helm install tiptree-platform tiptree/platform -f values.yaml

Monitoring

We recommend using Prometheus and Grafana for monitoring:

1. Metrics are exposed at /metrics
2. Use provided Grafana dashboards
3. Configure alerts for key metrics

Backup and Recovery

1. Database backups:

   • Schedule regular backups
   • Test recovery procedures
   • Store backups securely

2. Configuration backups:

   • Version control for configs
   • Document all customizations
   • Maintain deployment scripts