Configuration
Kinetiqo is configured entirely through environment variables.
1. Strava API Credentials
Register an application in the Strava API Settings to obtain the necessary credentials.
| Variable | Description | Required |
|---|---|---|
STRAVA_CLIENT_ID |
Strava Application Client ID. | ✅ |
STRAVA_CLIENT_SECRET |
Strava Application Client Secret. | ✅ |
STRAVA_REFRESH_TOKEN |
Valid Refresh Token with activity:read_all scope. |
✅ |
2. Database Configuration
Define DATABASE_TYPE as either postgresql (default) or mysql.
PostgreSQL (Default)
| Variable | Description | Default |
|---|---|---|
POSTGRESQL_HOST |
Database server hostname. | localhost |
POSTGRESQL_PORT |
Database server port. | 5432 |
POSTGRESQL_USER |
Database username. | postgres |
POSTGRESQL_PASSWORD |
Database password. | postgres |
POSTGRESQL_DATABASE |
Database name. | kinetiqo |
POSTGRESQL_SSL_MODE |
SSL connection mode (disable, require, etc.). |
disable |
MySQL / MariaDB
| Variable | Description | Default |
|---|---|---|
MYSQL_HOST |
Database server hostname. | localhost |
MYSQL_PORT |
Database server port. | 3306 |
MYSQL_USER |
Database username. | root |
MYSQL_PASSWORD |
Database password. | - |
MYSQL_DATABASE |
Database name. | kinetiqo |
MYSQL_SSL_MODE |
SSL connection mode. | disable |
Note: For MySQL, ensure the user has
CREATEandALL PRIVILEGESon the target database to allow for schema management.
3. Scheduling (Cron)
The Docker image includes a cron scheduler. Define schedules using standard cron syntax.
| Variable | Description | Example |
|---|---|---|
FULL_SYNC |
Schedule for full synchronization. | 0 3 * * * (Daily at 3 AM) |
FAST_SYNC |
Schedule for incremental synchronization. | */15 * * * * (Every 15 minutes) |
4. Web Interface Configuration
| Variable | Description | Default |
|---|---|---|
WEB_LOGIN |
Username for web access. | admin |
WEB_PASSWORD |
Password for web access. | admin123 |
Note: Synchronization errors are recorded in the
logsdatabase table and are accessible via the Web UI ordocker logs.