Installation

Prerequisites

Docker and Docker Compose
Git

System Requirements

Memory: Minimum 4GB RAM, 8GB recommended
Storage: 10GB free space for logs and data
Network: Port 8000 (FastAPI) - other services run in Docker

Installation Steps

Clone the repository

git clone https://github.com/cmgoffena13/watcher.git
cd watcher

Set up environment variables

Create a .env file (see Configuration for complete configuration options):

# Development
ENV_STATE=dev
TEST_DATABASE_URL=postgresql+asyncpg://user:password@localhost:5432/watcher_test
DEV_LOGFIRE_TOKEN=your_logfire_token_here
DEV_SLACK_WEBHOOK_URL=your_slack_webhook_url_here

Note

TEST_DATABASE_URL is only needed for tests.

Start services with Docker Compose
```
docker-compose up -d
```

Verification

Once running, you can verify the local development installation:

API Documentation: http://localhost:8000/scalar
Health Check: http://localhost:8000/
Diagnostics: http://localhost:8000/diagnostics