mirror of https://github.com/DRYTRIX/TimeTracker.git synced 2026-01-06 11:40:52 -06:00

Files

Dries Peeters f390a13474 chore(devops): streamline Docker Compose and refresh docs/config

- Simplify docker-compose setup and align environment defaults
- Update README and Quick Start to reflect the new compose flow
- Refine app initialization and configuration for clearer env handling
- Minor consistency and cleanup in config modules

No breaking changes expected.

2025-10-20 20:44:11 +02:00

1.1 KiB

Raw Blame History

Quick Start: Local Development with Docker Compose

TL;DR - Fastest Local Start

git clone https://github.com/drytrix/TimeTracker.git
cd TimeTracker

cp env.example .env
# Edit .env and set a strong SECRET_KEY

docker-compose -f docker-compose.example.yml up -d

# Open http://localhost:8080

See the full Docker Compose setup guide: docs/DOCKER_COMPOSE_SETUP.md.

Local Development (Python) Alternative

If you prefer to run locally with Python:

python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt
python app.py

Analytics & Telemetry (Optional)

To test PostHog or Sentry in development, set the respective variables in .env and restart the app. For advanced local analytics configuration, see docs/analytics.md and assets/README.md.

Troubleshooting

CSRF token errors: For HTTP (localhost), set WTF_CSRF_SSL_STRICT=false and ensure SESSION_COOKIE_SECURE=false/CSRF_COOKIE_SECURE=false.
Database not ready: The app waits for Postgres healthcheck; check docker-compose logs db.
Timezone issues: Set TZ to your locale.