feat: dockerize it

Author: kennym

.dockerignore

@@ -0,0 +1,28 @@
+# Secrets and local data
+.env
+data/
+session/
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Git
+.git/
+.gitignore
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# OS
+.DS_Store
+
+# Development
+.claude/

.gitignore

@@ -3,8 +3,9 @@
 *.pem
 *.key
 
-# Database
+# Database and session
 data/
+session/
 *.db
 
 # Python

Dockerfile

@@ -0,0 +1,17 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+
+# Install dependencies first for better caching
+COPY pyproject.toml README.md ./
+COPY src/ ./src/
+COPY templates/ ./templates/
+
+RUN pip install --no-cache-dir -e .
+
+# Session cookies and database will be mounted at runtime
+VOLUME ["/root/.find-my-timeline", "/app/data"]
+
+EXPOSE 5000
+
+CMD ["find-my-timeline", "start"]

README.md

@@ -48,3 +48,29 @@ Set in `.env` or pass as CLI options:
 - `POLL_MAX_INTERVAL` - Maximum poll interval in minutes (default: 10)
 - `DATABASE_PATH` - SQLite database path (default: ./data/locations.db)
 - `WEB_HOST` / `WEB_PORT` - Web server binding (default: 127.0.0.1:5000)
+
+## Docker
+
+### First-time setup (interactive 2FA required)
+
+```bash
+cp .env.example .env
+# Edit .env with your Apple ID
+
+mkdir -p session data
+docker compose run --rm find-my-timeline find-my-timeline auth
+# Enter 2FA code when prompted
+```
+
+### Run
+
+```bash
+docker compose up -d
+# Open http://localhost:5000
+```
+
+### Re-authenticate (when session expires, ~90 days)
+
+```bash
+docker compose run --rm find-my-timeline find-my-timeline auth
+```

docker-compose.yml

@@ -0,0 +1,13 @@
+services:
+  find-my-timeline:
+    build: .
+    ports:
+      - "5000:5000"
+    volumes:
+      - ./data:/app/data
+      - ./session:/root/.find-my-timeline
+    env_file:
+      - .env
+    environment:
+      - WEB_HOST=0.0.0.0
+    restart: unless-stopped