probo/docs/INSTALLATION.md

Probo Installation Guide

This document provides comprehensive installation instructions for the Probo compliance management platform daemon (probod).

Installation Methods

Probo can be deployed using either the official Docker image or pre-compiled binaries available through GitHub releases.

Docker Installation

The official Docker images are available on GitHub Container Registry and support multiple architectures:

• Multi-architecture image: ghcr.io/getprobo/probo:latest
• AMD64 (x86_64): ghcr.io/getprobo/probo:latest-amd64
• ARM64: ghcr.io/getprobo/probo:latest-arm64

Basic Docker Setup

To run Probo using Docker:

docker run -d \
  --name probod \
  -p 8080:8080 \
  -v /path/to/config.yaml:/etc/probod/config.yaml \
  ghcr.io/getprobo/probo:latest

Docker Compose Setup

For a complete setup with dependencies, you can use Docker Compose:

version: "3.8"

services:
  probod:
    image: ghcr.io/getprobo/probo:latest
    ports:
      - "8080:8080"
    volumes:
      - ./config.yaml:/etc/probod/config.yaml
      - ./data:/data
    environment:
      - PROBOD_CONFIG=/etc/probod/config.yaml
    depends_on:
      - postgres
      - minio

  postgres:
    image: postgres:15
    environment:
      POSTGRES_DB: probod
      POSTGRES_USER: probod
      POSTGRES_PASSWORD: probod
    volumes:
      - postgres_data:/var/lib/postgresql/data
    ports:
      - "5432:5432"

  minio:
    image: minio/minio:latest
    command: server /data --console-address ":9001"
    environment:
      MINIO_ROOT_USER: probod
      MINIO_ROOT_PASSWORD: thisisnotasecret
    volumes:
      - minio_data:/data
    ports:
      - "9000:9000"
      - "9001:9001"

volumes:
  postgres_data:
  minio_data:

Docker Architecture Support

The Docker images support the following architectures:

• linux/amd64 (x86_64) - Standard 64-bit Intel/AMD processors
• linux/arm64 - ARM 64-bit processors (Apple Silicon, AWS Graviton, etc.)

Multi-architecture images automatically select the appropriate variant for your platform.

Binary Installation

Pre-compiled binaries are available for download from the GitHub releases page.

Supported Platforms

The following platforms are officially supported:

• Windows: AMD64 (x86_64)
• macOS: AMD64 (x86_64) and ARM64 (Apple Silicon)
• Linux: AMD64 (x86_64) and ARM64 (via Docker)

If your specific platform is not available, please contact us, and we may be able to add support for additional architectures.

Installation Steps

1. Download the Binary

   Visit the GitHub releases page and download the appropriate archive for your platform:

   • Windows: probod_Windows_x86_64.zip
   • macOS (Intel): probod_Darwin_x86_64.tar.gz
   • macOS (Apple Silicon): probod_Darwin_arm64.tar.gz

2. Extract the Archive

   # For tar.gz files (macOS/Linux)
   tar -xzf probod_Darwin_x86_64.tar.gz
   
   # For zip files (Windows)
   # Use your preferred extraction tool
   

3. Install the Binary

   macOS/Linux:

   # Move to a directory in your PATH
   sudo mv probod /usr/local/bin/
   
   # Make executable (if not already)
   sudo chmod +x /usr/local/bin/probod
   

   Windows:

   # Move probod.exe to a directory in your PATH
   # Or add the current directory to your PATH environment variable
   

4. Verify Installation

   probod --version
   

Running the Binary

Once installed, you can run Probo with a configuration file:

# Using the default configuration location
probod --config /etc/probod/config.yaml

# Or specify a custom configuration file
probod --config ./my-config.yaml

System Requirements

Minimum Requirements

• CPU: 1 core, 2 GHz
• Memory: 1 GB RAM
• Storage: 10 GB available space
• Network: Internet connectivity for external integrations

Recommended Requirements

• CPU: 2+ cores, 2.4 GHz
• Memory: 4 GB RAM
• Storage: 50 GB available space (SSD preferred)
• Network: Stable internet connection

Dependencies

Probo requires the following external services:

1. PostgreSQL Database (version 12 or higher)
2. S3-Compatible Storage (AWS S3, MinIO, etc.)
3. Chrome/Chromium (for PDF generation via Chrome DevTools Protocol)

Optional dependencies:

• SMTP Server (for email notifications)
• OpenAI API (for AI-powered features)

Quick Start

1. Database Setup

Create a PostgreSQL database for Probo:

CREATE DATABASE probod;
CREATE USER probod WITH PASSWORD 'your_secure_password';
GRANT ALL PRIVILEGES ON DATABASE probod TO probod;

2. Configuration

Create a basic configuration file (config.yaml):

probod:
  hostname: "localhost:8080"
  encryption-key: "your-base64-encoded-encryption-key"

  pg:
    addr: "localhost:5432"
    username: "probod"
    password: "your_secure_password"
    database: "probod"

  aws:
    region: "us-east-1"
    bucket: "probod"
    access-key-id: "your-access-key"
    secret-access-key: "your-secret-key"
    endpoint: "http://localhost:9000" # For MinIO

3. Start the Service

# Using Docker
docker run -d \
  --name probod \
  -p 8080:8080 \
  -v ./config.yaml:/etc/probod/config.yaml \
  ghcr.io/getprobo/probo:latest

# Using Binary
probod --config config.yaml

4. Access the Application

Open your web browser and navigate to http://localhost:8080 to access the Probo web interface.

Production Deployment

Security Considerations

1. Use strong, unique secrets for all authentication components
2. Enable TLS for all external communications
3. Use managed database services with encryption at rest
4. Implement proper monitoring and logging
5. Regular security updates and vulnerability assessments

Load Balancing

For high-availability deployments, consider using:

• Reverse Proxy: Nginx, HAProxy, or cloud load balancers
• Database Clustering: PostgreSQL with read replicas
• File Storage: Distributed S3-compatible storage

Monitoring

Probo provides metrics and health checks:

• Health Check: GET /health
• Metrics: Prometheus-compatible metrics endpoint
• Logging: Structured JSON logging with configurable levels

Troubleshooting

Common Installation Issues

1. Permission Denied (Binary)

   chmod +x probod
   

2. Database Connection Failed

   • Verify database credentials and network connectivity
   • Check PostgreSQL is running and accepting connections

3. Docker Image Pull Failed

   docker login ghcr.io
   docker pull ghcr.io/getprobo/probo:latest
   

4. Port Already in Use

   # Find process using port 8080
   lsof -i :8080
   
   # Or use a different port in configuration
   

Getting Help

• Documentation: Check the configuration reference
• GitHub Issues: Report bugs and request features
• Community: Join our community discussions

Log Analysis

Enable debug logging to troubleshoot issues:

probod:
  # ... other configuration
  log-level: debug

Check startup logs for configuration validation errors and service initialization issues.