Installation

The source code is in a private repository. Request access via the source form on velostack.eu. PostgreSQL 15 is recommended for production.

Prerequisites

• Docker + Docker Compose or Python 3.11+
• At least 512 MB RAM, port 8000 free
• PostgreSQL 15 for production

Docker

git clone https://github.com/Veloflott/veloflott-velostack-veloconnect.git
cd veloflott-velostack-veloconnect
cp .env.example .env
docker compose up -d
docker compose exec veloconnect python scripts/create_admin.py

Manual

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
cp .env.example .env
alembic upgrade head
uvicorn velostack.main:app --host 0.0.0.0 --port 8000 --app-dir src

Verify

• GET /health returns HTTP 200.
• GET /health/timers shows sync and timer status.
• Web UI reachable at /admin/.
• MCP endpoint reachable at /mcp.

• Next: configuration →