From bbf39247edba870ba4a96789c7d0c90b00cd9700 Mon Sep 17 00:00:00 2001
From: xpltd_admin <admin@xpltd.co>
Date: Fri, 3 Apr 2026 23:04:25 -0600
Subject: [PATCH] Create Getting-Started wiki page for media-rip

---
 Getting-Started.-.md | 90 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 90 insertions(+)
 create mode 100644 Getting-Started.-.md

diff --git a/Getting-Started.-.md b/Getting-Started.-.md
new file mode 100644
index 0000000..8f1adb3
--- /dev/null
+++ b/Getting-Started.-.md
@@ -0,0 +1,90 @@
+# Getting Started
+
+| Meta | Value |
+|------|-------|
+| **Repo** | `xpltdco/media-rip` |
+| **Page** | `Getting-Started` |
+| **Audience** | developers, newcomers |
+| **Last Updated** | 2026-04-04 |
+| **Status** | current |
+
+## Quick Start (Docker)
+
+```bash
+docker run -d --name media-rip \
+  -p 8080:8000 \
+  -v ./downloads:/downloads \
+  -v mediarip-data:/data \
+  --restart unless-stopped \
+  ghcr.io/xpltdco/media-rip:latest
+```
+
+Open **http://localhost:8080** in your browser.
+
+## Docker Compose
+
+```bash
+git clone https://git.xpltd.co/xpltdco/media-rip.git
+cd media-rip
+docker compose up -d
+```
+
+Access at **http://localhost:8080**.
+
+## Local Development
+
+### Prerequisites
+
+| Requirement | Version | Purpose |
+|-------------|---------|---------|
+| **Python** | >= 3.12 | Backend |
+| **Node.js** | >= 22 | Frontend |
+| **yt-dlp** | Latest | Media downloading |
+| **ffmpeg** | Any recent | Post-processing |
+
+### Backend
+
+```bash
+cd backend
+pip install -r requirements.txt
+python start.py
+```
+
+Backend starts on http://localhost:8000.
+
+### Frontend
+
+```bash
+cd frontend
+npm install
+npm run dev
+```
+
+Vite dev server starts on http://localhost:5173 with HMR.
+
+## Environment Variables
+
+See full [Configuration](Configuration) page. Quick essentials:
+
+| Variable | Default | Purpose |
+|----------|---------|---------|
+| `MEDIARIP__SERVER__PORT` | `8000` | Server port |
+| `MEDIARIP__DOWNLOADS__OUTPUT_DIR` | `/downloads` | Where media goes |
+| `MEDIARIP__SESSION__MODE` | `isolated` | `isolated`, `shared`, or `open` |
+| `MEDIARIP__ADMIN__ENABLED` | `true` | Admin panel toggle |
+| `MEDIARIP__ADMIN__PASSWORD` | — | Admin password (hashed at startup) |
+
+## Troubleshooting
+
+### Downloads fail immediately
+- Check yt-dlp is installed and updated: `yt-dlp --version`
+- Check ffmpeg is available: `ffmpeg -version`
+- View error details in admin panel error log
+
+### Network filesystem issues
+- If `/downloads` is on NFS/CIFS/SMB, SQLite automatically uses DELETE journal mode
+- If you see "database is locked" errors, ensure only one instance accesses the DB
+
+### Themes not loading
+- Custom themes mount to `/themes` volume
+- Each theme needs `metadata.json` + `theme.css`
\ No newline at end of file