Getting Started with TruSpace

Welcome to TruSpace! This section will help you get up and running quickly.

• Quick Start (5 minutes)

  ---

  Get TruSpace running with a single command.

  Quick Start Guide

• Installation Guides

  ---

  Detailed setup for different environments.

  Installation Options

• First Steps

  ---

  Create your first user and workspace.

  First Steps

• FAQ

  ---

  Common questions and answers.

  FAQ

Prerequisites

Before installing TruSpace, ensure you have:

Requirement	Minimum	Recommended
Docker	20.10+	Latest
Docker Compose	2.0+	Latest
RAM	4 GB	8 GB+
Storage	10 GB	50 GB+
OS	Linux, macOS, Windows (WSL)	Ubuntu 22.04 LTS

Check Docker Installation

docker --version
docker compose version

Choose Your Path

flowchart TD
    A[Start] --> B{What's your goal?}
    B -->|Try it out| C[Quick Start]
    B -->|Development| D[Local Dev Setup]
    B -->|Production| E[Production Guide]
    B -->|Low-power device| F[Raspberry Pi]

    C --> G[localhost:3000]
    D --> G
    E --> H[Custom Domain]
    F --> G

    style A fill:#7c3aed,stroke:#333,color:#fff
    style G fill:#10b981,stroke:#333,color:#fff
    style H fill:#10b981,stroke:#333,color:#fff

What Gets Installed?

TruSpace deploys the following containers:

Container	Purpose	Port
truspace-frontend	Next.js web interface	3000
truspace-backend	Express API server	8000
ipfs0	IPFS node (Kubo)	4001, 5001, 8080
cluster0	IPFS Cluster daemon	9094, 9096-9097
truspace-webui	Open Web UI (AI)	3333
ollama	LLM engine	11434

AI Components Optional

The Ollama and Open Web UI containers are optional. Use --no-ai flag to skip them.