Erich Blume
b8104d75ad
## Summary - Move all existing zettelkasten cards from `docs/` to `docs/zk/` as a temporary holding area - Update `zk-docs` mise task to look in the new location - Add `docs/README.md` explaining the Diataxis-based restructuring plan and target audiences ## Context This is phase 1 of a multi-phase documentation restructuring effort. The goal is to reorganize docs to follow the Diataxis framework while serving multiple audiences: 1. Erich (owner) - knowledge graph/zk 2. Claude/AI agents - memory and context enrichment 3. New external readers - high-level overview 4. Potential operators/contributors - onboarding 5. Replicators - people wanting to duplicate the approach ## Testing - [x] Verified `mise run zk-docs` still works with the new path - [x] Updated obsidian.nvim config (in ~/.config/nvim) to point to new path ## Note The obsidian.nvim config change is outside this repo but was made as part of this work. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/84
113 lines
3.3 KiB
Markdown
113 lines
3.3 KiB
Markdown
---
|
|
id: teslamate
|
|
aliases:
|
|
- teslamate
|
|
- tesla
|
|
tags:
|
|
- blumeops
|
|
---
|
|
|
|
# TeslaMate
|
|
|
|
TeslaMate is a self-hosted Tesla data logger running in Kubernetes (minikube on indri), collecting and visualizing vehicle data from the Tesla Owner API.
|
|
|
|
## Service Details
|
|
|
|
- URL: https://tesla.tail8d86e.ts.net
|
|
- Namespace: `teslamate`
|
|
- Image: `teslamate/teslamate:2.2.0`
|
|
- Database: [[postgresql]] (CloudNativePG cluster at pg.tail8d86e.ts.net)
|
|
- ArgoCD app: `teslamate`
|
|
|
|
## What TeslaMate Collects
|
|
|
|
- Battery level, state of charge, range estimates
|
|
- Charging sessions (location, energy, cost, duration)
|
|
- Drives (distance, efficiency, routes)
|
|
- Climate/HVAC usage
|
|
- Software update history
|
|
- Vampire drain analysis
|
|
- Vehicle states (asleep, driving, charging, online)
|
|
|
|
## Grafana Dashboards
|
|
|
|
18 dashboards available in Grafana under the "TeslaMate" folder at https://grafana.tail8d86e.ts.net:
|
|
|
|
- Overview, Charges, Drives, Efficiency, States
|
|
- Battery Health, Vampire Drain, Statistics
|
|
- Charge Level, Locations, Trip, Mileage
|
|
- Drive Stats, Charging Stats, Projected Range
|
|
- Timeline, Updates, Visited
|
|
|
|
Dashboards use the `TeslaMate` PostgreSQL datasource (not Prometheus).
|
|
|
|
## Useful Commands
|
|
|
|
```bash
|
|
# View logs
|
|
kubectl --context=minikube-indri -n teslamate logs -f deployment/teslamate
|
|
|
|
# Check pod status
|
|
kubectl --context=minikube-indri -n teslamate get pods
|
|
|
|
# Restart deployment
|
|
kubectl --context=minikube-indri -n teslamate rollout restart deployment/teslamate
|
|
|
|
# Sync from ArgoCD
|
|
argocd app sync teslamate
|
|
```
|
|
|
|
## Credentials
|
|
|
|
**1Password items (blumeops vault):**
|
|
- `TeslaMate` - contains `db_password` and `api_enc_key` fields
|
|
|
|
**Kubernetes secrets:**
|
|
- `teslamate-db` (teslamate ns) - DATABASE_PASS for PostgreSQL connection
|
|
- `teslamate-encryption` (teslamate ns) - ENCRYPTION_KEY for token encryption
|
|
- `blumeops-pg-teslamate` (databases ns) - CloudNativePG managed role password
|
|
- `grafana-teslamate-datasource` (monitoring ns) - Grafana datasource password
|
|
|
|
## Backup
|
|
|
|
TeslaMate data is backed up via [[borgmatic]]:
|
|
- PostgreSQL database `teslamate` included in `borgmatic_postgresql_databases`
|
|
- Backed up alongside miniflux to sifaka NAS
|
|
|
|
## Tesla API Authentication
|
|
|
|
TeslaMate uses Tesla's Owner API (not Fleet API) via OAuth:
|
|
|
|
1. Access https://tesla.tail8d86e.ts.net
|
|
2. Click "Sign in with Tesla"
|
|
3. Complete OAuth flow in browser
|
|
4. Tokens are encrypted with ENCRYPTION_KEY and stored in database
|
|
5. TeslaMate automatically refreshes tokens as needed
|
|
|
|
**Standalone OAuth tool:** If you need to manually obtain tokens, there's a Rust-based helper:
|
|
- Mirror: https://forge.tail8d86e.ts.net/eblume/tesla_auth.git
|
|
- Runs OAuth flow and outputs access/refresh tokens
|
|
|
|
## Database Notes
|
|
|
|
- TeslaMate requires PostgreSQL 17.3+ or 18.x
|
|
- The `teslamate` user has superuser privileges (required for extension management during migrations)
|
|
- Extensions used: `cube`, `earthdistance` (for geospatial calculations)
|
|
|
|
## Related
|
|
|
|
- [[1767747119-YCPO|BlumeOps]]
|
|
- [[argocd|ArgoCD]]
|
|
- [[postgresql|PostgreSQL]]
|
|
- [[borgmatic|Borgmatic]]
|
|
|
|
## Log
|
|
|
|
### Thu Jan 23 2026
|
|
|
|
- Initial deployment to Kubernetes
|
|
- 18 Grafana dashboards imported from TeslaMate project
|
|
- Upgraded CloudNativePG 1.25 -> 1.28 for major version upgrade support
|
|
- Upgraded PostgreSQL 17.2 -> 18.1 (required for TeslaMate 2.2.0)
|
|
- Tailscale Ingress at `tesla.tail8d86e.ts.net`
|
|
- Backup configuration added to borgmatic
|