Skip to content

Installation Options

TruSpace supports multiple deployment scenarios. Choose the one that fits your needs:

  • Local Development

    Best for: Developers, testing, evaluation

    • Hot reload for frontend/backend
    • Debug-friendly setup
    • Quick iteration

    Local Dev Setup

  • Docker Deployment

    Best for: Quick setup, standard deployment

    • One-command installation
    • Consistent environment
    • Easy updates

    Docker Guide

  • Raspberry Pi

    Best for: Low-power, edge deployments

    • ARM64 compatible
    • Low resource usage
    • Always-on node

    Raspberry Pi Guide

  • Production

    Best for: Enterprise, multi-user

    • Custom domains
    • SSL/TLS setup
    • High availability

    Production Guide

Comparison Matrix

Feature Local Dev Docker Raspberry Pi Production
Setup Time 10 min 5 min 15 min 30+ min
Hot Reload ✅ ❌ ❌ ❌
Resource Usage High Medium Low Medium
Custom Domain ❌ Optional Optional ✅
SSL/TLS ❌ Optional Optional ✅
Recommended RAM 8 GB+ 4 GB+ 4 GB+ 8 GB+
AI Features ✅ ✅ Limited ✅

Prerequisites

All installation methods require:

  • Docker 20.10+
  • Docker Compose 2.0+
  • Git
  • Additional 4 GB RAM
  • ~4 GB storage for models
  • CPU with AVX2 support (or GPU)
  • Domain name
  • SSL certificate
  • Reverse proxy (nginx/traefik)

Quick Decision Guide

flowchart TD
    A[Start] --> B{Are you a developer?}
    B -->|Yes| C{Need hot reload?}
    B -->|No| D{Low-power device?}

    C -->|Yes| E[Local Dev]
    C -->|No| F[Docker]

    D -->|Yes| G[Raspberry Pi]
    D -->|No| H{Need custom domain?}

    H -->|Yes| I[Production]
    H -->|No| F

    style E fill:#10b981,stroke:#333,color:#fff
    style F fill:#10b981,stroke:#333,color:#fff
    style G fill:#10b981,stroke:#333,color:#fff
    style I fill:#10b981,stroke:#333,color:#fff