Add files via upload

docs/synology.md

@@ -0,0 +1,127 @@
+# 🗺️ Installing TRIP on Synology NAS Using Docker and Portainer
+
+This guide explains how to deploy [TRIP](https://github.com/itskovacs/trip) on a Synology NAS using Docker and Portainer. TRIP is a minimalist, privacy-first map and POI tracking app that is fully self-hostable.
+
+---
+
+## 🧰 Prerequisites
+
+- A Synology NAS with Docker support
+- [Docker](https://www.synology.com/en-us/dsm/packages/Docker) installed via Synology Package Center
+- [Portainer](https://www.portainer.io/) (Community Edition) installed and running
+- Basic familiarity with Synology DSM, Portainer, and local network setup
+
+---
+
+## 📁 Step 1: Create a Storage Directory
+
+Create a folder on your NAS to persist TRIP’s storage:
+
+```bash
+mkdir -p /volume1/docker/trip-storage
+```
+
+You can also do this via File Station by creating:
+
+```
+/volume1/docker/trip-storage
+```
+
+---
+
+## 🚀 Step 2: Deploy TRIP in Portainer
+
+### ✅ Option A: Docker Compose (Recommended)
+
+1. Open **Portainer**.
+2. Go to **Stacks** → **Add Stack**.
+3. Name your stack (e.g., `trip`).
+4. Paste the following:
+
+```yaml
+version: '3.9'
+services:
+  trip:
+    container_name: trip
+    image: ghcr.io/itskovacs/trip:latest
+    user: 1000:1000 #change these values to match those of your synology setup PUID:PGID
+    security_opt:
+      - no-new-privileges:true
+    volumes:
+      - /volume1/docker/trip-storage:/app/storage
+    restart: on-failure:5
+    ports:
+      - "8080:8000"
+```
+
+5. Click **Deploy the stack**.
+
+---
+
+### ⚙️ Option B: Manual Container (Docker Run Equivalent)
+
+1. In **Portainer**, go to **Containers** → **Add Container**.
+2. Fill out the following fields:
+
+- **Name**: `trip`
+- **Image**: `ghcr.io/itskovacs/trip:latest`
+- **Port mapping**: `8080` → `8000`
+- **Volume mapping**:
+  - Host: `/volume1/docker/trip-storage`
+  - Container: `/app/storage`
+
+3. Click **Deploy the container**.
+
+---
+
+## 🌐 Step 3: Access the App
+
+Open a browser and go to:
+
+```
+http://<YOUR_NAS_IP>:8080
+```
+
+You should see the TRIP web interface.
+
+---
+
+## ⚙️ Step 4: Add Optional Configuration (e.g., Authentication)
+
+TRIP supports advanced configuration via a `config.yml` file. To enable it:
+
+1. Place your `config.yml` inside `/volume1/docker/trip-storage`.
+2. The app will detect it automatically on container restart.
+
+> For authentication, theming, and more, refer to:  
+> [TRIP Configuration Docs](https://github.com/itskovacs/trip#configuration)
+
+---
+
+## 🧯 Troubleshooting
+
+- **Can’t access the app?**
+  - Ensure the NAS IP is correct and port 8080 is not blocked.
+- **Data not saving?**
+  - Confirm that the `/app/storage` volume is mapped properly.
+- **Need to upgrade?**
+  - Edit the image tag in your Docker Compose or Container to the new version and redeploy.
+
+---
+
+## 📌 Example Quick Reference
+
+| Item           | Value                                 |
+|----------------|---------------------------------------|
+| App URL        | `http://<NAS-IP>:8080`                |
+| Docker Image   | `ghcr.io/itskovacs/trip:latest`       |
+| Storage Path   | `/volume1/docker/trip-storage`        |
+| Port Mapping   | `8080:8000`                           |
+
+---
+
+## ✅ Final Notes
+
+- [TRIP GitHub Repo](https://github.com/itskovacs/trip)
+- [Latest Release](https://github.com/itskovacs/trip/releases)
+- If using a reverse proxy (e.g., Synology Application Portal or NGINX), map `/` to port `8080`.