Premium Electric Vehicle Data Monitoring for Volkswagen Group EVs
Use iVDrive online at ivdrive.eu — request an invite, get approved, and view your EV data. Self-hosting is available for those who prefer to run the stack themselves.
Beta — iVDrive is in active development. We're currently in an invite-only beta to ensure stability as we scale.
Request an invite at ivdrive.eu/register to join the waitlist!
We welcome contributors, feedback, and new users!
Try iVDrive (Beta) • Getting Started • Documentation • Community • Support
iVDrive is a premium EV data monitoring app for Volkswagen Group vehicles (starting with Škoda). Use it online at ivdrive.eu — request an invite, join the beta, and get a single dashboard for trips, charging, efficiency, and statistics. If you prefer to run the stack yourself, you can self-host with Docker.
- Beta Access — Use online at ivdrive.eu. Request an invite, get approved, and start viewing your data.
- VW Group EV focus — Built for Škoda Connect first; designed to extend to other Volkswagen Group EVs.
- Single dashboard — Trips, charging, efficiency, locations, and driving statistics in one place.
- ABRP live telemetry (optional) — Push SOC, charging and position data to A Better Route Planner for accurate live route planning. Disabled by default; enable in Settings → Integrations. Note: ABRP Custom connections expose Driving/Charging data only — remote vehicle control from ABRP is not supported (ABRP-side limitation).
- Self-host optional — For advanced users: run the full stack yourself with Docker (see Getting Started).
iVDrive runs as a multi-container Docker environment:
| Component | Technology | Purpose |
|---|---|---|
| Frontend | Next.js (React, App Router), Tailwind, Recharts, React-Leaflet | Web UI and charts |
| Backend API | FastAPI, SQLAlchemy (async), Pydantic | REST API, auth, vehicle commands |
| Collector | Python worker | Polls Škoda API, stores telemetry in the database |
| Database | PostgreSQL | Users, vehicles, telemetry history |
| Cache | Valkey (Redis-compatible) | State, cache, pub/sub |
The frontend proxies /api/* to the backend so you can serve everything from one origin (e.g. https://ivdrive.eu).
- EV owners with Škoda (and compatible VW Group) vehicles — use ivdrive.eu to see your driving and charging data in one place.
- Self-hosters (optional) — if you have the know-how, you can run the stack on your own server or NAS.
- Developers — build on the REST API or extend the collector; see CONTRIBUTING.md.
Screenshots from the live app at ivdrive.eu. Light and dark theme available — see assets/screenshots/.
App navigation (animated):
| Login | Add vehicle | Vehicle overview |
|---|---|---|
| Homepage | Settings |
|---|---|
- Go to https://ivdrive.eu.
- Open the Register page and fill in the form.
- Wait for the email with your invite to be sent.
- Click the link in the email to verify your email.
- Register a new account with your email and password.
- Add your vehicle with requested credentials.
- Your data will sync and appear in the dashboard — trips, charging, statistics, and more.
If you prefer to run the stack yourself (e.g. on your NAS):
-
Clone the repository
git clone https://github.com/m7xlab/iVDrive.git cd iVDrive -
Configure environment — Copy .env.example to
.envand setPOSTGRES_PASSWORD,VALKEY_PASSWORD,JWT_SECRET_KEY,ENCRYPTION_KEY(see.env.examplefor notes). -
Run with Docker Compose
docker compose up -d
- Web UI: http://localhost:3035 (or your host/port).
- API: http://localhost:8000.
-
Initialize Database (Required for Self-Hosters) Ensure the database and tables are created correctly:
docker compose exec ivdrive-api env PYTHONPATH=/app python -m app.scripts.init_db docker compose exec ivdrive-api env PYTHONPATH=/app alembic stamp head
-
Promote Admin User (Required for Self-Hosters) After registering your first user via the UI, promote them to superuser to access the admin panel:
docker compose exec ivdrive-api env PYTHONPATH=/app python -m app.scripts.promote_user --email your@email.com -
Add your vehicle in the UI with your Škoda Connect credentials.
For more detail, see Project overview and the docs.
A separate optional service (landing/) provides the public marketing site at the apex domain and reverse-proxies the app.
- Self-hosters: ignore it —
docker compose upstill opens the console at/. - Production:
docker compose -f docker-compose.yml -f docker-compose.landing.yml up -d --build - Details: landing/README.md
- User docs (Docusaurus) —
documentation/(npm start/npm run build), covering getting started, user guide, self-hosting, reference and community. - Documentation index — Markdown sources and project overview.
- Self-hosting guide — Run the stack with Docker on your own server or NAS.
- Changelog — Release history and notable changes.
- Roadmap — Current focus and planned directions.
We welcome contributions: bug reports, feature ideas, and pull requests.
- Contributing guide — How to set up your environment and submit changes.
- Code of conduct — Community standards.
- Security policy — How to report vulnerabilities (please do not use public issues for security).
See our Contributing Guide for details.
iVDrive is available under the Elastic License 2.0 (ELv2). You may use, modify, and distribute the software subject to the terms in the license. The license does not allow offering the software to third parties as a hosted or managed service. See LICENSE for the full text.
Ready to monitor your EV data?
Try iVDrive
m7xlab (m7xlabaroty) · iVDrive · Thank you