# Docker Compose

## Prerequisites

* Install git, zip
* [Install docker and docker-compose](https://docs.docker.com/engine/install/)
* [Install Deno](https://deno.com/)
* [Install Supabase CLI (optional)](https://supabase.com/docs/guides/cli/getting-started?queryGroups=platform\&platform=linux#installing-the-supabase-cli)

Instructions for Linux OSes:

{% tabs %}
{% tab title="Fedora/CentOS" %}

```sh
sudo yum install -y git zip yum-utils

# Install and setup Docker for non-root user
yes | sudo  yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
yes | sudo  yum install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker
sudo usermod -aG docker $USER
newgrp docker

# Install Deno
curl -fsSL https://deno.land/install.sh > /tmp/install.sh
chmod +x /tmp/install.sh
sudo env DENO_INSTALL=/usr/local /tmp/install.sh
rm /tmp/install.sh
```

{% endtab %}

{% tab title="Ubuntu" %}

```sh
TODO
```

{% endtab %}
{% endtabs %}

## Self-hosting with Docker Compose

### Download source code

Clone the code using git:

```sh
git clone https://github.com/space-operator/flow-backend
```

Go to `docker` folder:

```sh
cd flow-backend/docker
```

Every commands in this tutorial must be run in `flow-backend/docker` folder.

## Generate secrets and configurations

Our Docker Compose setup needs 2 configuration files, both are located in `flow-backend/docker` folder:

* `.env` : dotenv file containing environment variables
* `.config.toml`: configuration file used by flow-server.

Template for these files are in `env.example` and `flow-server-config.toml` .

Generate secrets and config files for your server:

```sh
./gen-secrets.ts
```

Generated secrets are saved in `.env` and `.config.toml` files.

The script use `env.example` and `flow-server-config.toml` as templates, you can edit them before running the script to customize values.

Start and wait for containers to be ready:

```sh
docker compose up -d --wait
```

Port binding:

* Supabase: port 8000
* Flow server: port 8080
* PostgreSQL: port 5432

To see Supabase Dashboard:

* Open `.env` file to see `DASHBOARD_USERNAME` and `DASHBOARD_PASSWORD` values:

```sh
cat .env | grep DASHBOARD
```

* Visit <http://localhost:8000/> .

## Export your data and use them in self-hosted server

Follow steps from [here](/self-hosting/export-data-to-your-instance.md)

## Stop and clean up

To stop services:

```
docker compose down
```

Stop and clean up all data:

```
docker compose down -v
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.spaceoperator.com/self-hosting/docker-compose.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.