> ## Documentation Index
> Fetch the complete documentation index at: https://docs.safaridesk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Open Source 

> Install, configure, and operate SafariDesk on your own infrastructure

# SafariDesk Open Source Guide

Choose the path that matches where you are right now. Start with Installation if you're setting up SafariDesk for the first time, or jump to Configuration and Operations when you are already running a stack.

<Card title="Quick start" icon="rocket" horizontal href="./installation">
  Follow the shortest path to a working deployment, then come back here for configuration, architecture, and maintenance.
</Card>

<Columns cols={2}>
  <Card title="What you'll need" icon="server" href="./installation">
    Docker, Docker Compose, a host with at least 4 GB RAM, and access to your `.env` file.
  </Card>

  <Card title="What you'll learn" icon="book" href="./architecture">
    How the stack is assembled, how licensing works, and how to keep the deployment healthy over time.
  </Card>
</Columns>

<Columns cols={2}>
  <Card title="Installation" icon="rocket" href="./installation">
    Set up Docker Compose, prepare your environment file, and start the full stack.
  </Card>

  <Card title="Configuration" icon="sliders" href="./configuration">
    Review the required environment variables, URLs, email settings, and optional AI values.
  </Card>

  <Card title="Architecture" icon="book" href="./architecture">
    Understand the deployment model, storage layout, and licensing flow.
  </Card>

  <Card title="Troubleshooting" icon="gear" href="./troubleshooting">
    Work through the most common startup and runtime issues.
  </Card>
</Columns>

## Quick links

* [Installation](./installation) — first-time install
* [Configuration](./configuration) — edit `.env` values
* [Update](./update) — upgrade an existing deployment
* [Uninstall](./uninstall) — remove the deployment
* [Troubleshooting](./troubleshooting) — common fixes

## What this deploys

The self-hosted stack includes:

* Frontend served by Nginx
* Django API
* Celery worker and scheduler
* PostgreSQL with pgvector
* Redis for cache and broker traffic

## Before you start

* Install Docker and Docker Compose on the target host
* Give the host at least 4 GB RAM for a small deployment
* Use a domain or local DNS record if you plan to expose the service publicly
* Run commands from the `Core/` folder