Installation

1. Clone the repository

git clone https://github.com/TM9657/flow-like.git
cd flow-like/apps/backend/docker-compose

2. Configure environment

Copy the example environment file:

cp .env.example .env

Edit .env with your configuration. At minimum, configure:

Storage provider credentials (see Storage Providers)
Database password (change the default)

3. Generate JWT keypair

The execution JWT system enables stateless trust between the API and runtime:

# From the repository root
./tools/gen-execution-keys.sh

Copy the output to your .env file:

EXECUTION_KEY=<base64-encoded-private-key>
EXECUTION_PUB=<base64-encoded-public-key>
EXECUTION_KID=execution-es256-v1

4. Create storage buckets

Before starting, create three buckets in your storage provider:

flow-like-meta (or your custom name)
flow-like-content (or your custom name)
flow-like-logs (or your custom name)

Update the bucket names in .env if using custom names.

5. Start services

docker compose up -d

This will:

Start PostgreSQL and wait for it to be healthy
Run database migrations via db-init
Start the API service
Start the execution runtime

6. Verify installation

Check that all services are running:

docker compose ps

Expected output:

NAME                              STATUS
docker-compose-api-1              running (healthy)
docker-compose-postgres-1         running (healthy)
docker-compose-runtime-1          running (healthy)

Check API health:

curl http://localhost:8080/health

View logs:

# All services
docker compose logs -f

# Specific service
docker compose logs -f api

7. Access the API

The API is available at http://localhost:8080 by default.

For production deployments, place a reverse proxy (nginx, Caddy, Traefik) in front to handle TLS termination.

Updating

To update to a newer version:

git pull
docker compose down
docker compose build --no-cache
docker compose up -d

Uninstalling

Remove all containers and volumes:

docker compose down -v