🗺️ Installing TRIP on Synology NAS Using Docker and Portainer

This guide explains how to deploy 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 installed via Synology Package Center
Portainer (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:

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)

Open Portainer.
Go to Stacks → Add Stack.
Name your stack (e.g., trip).
Paste the following:

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"

Click Deploy the stack.

⚙️ Option B: Manual Container (Docker Run Equivalent)

In Portainer, go to Containers → Add Container.
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

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:

Place your config.yml inside /volume1/docker/trip-storage.
The app will detect it automatically on container restart.

For authentication, theming, and more, refer to:
TRIP Configuration Docs

🧯 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
Latest Release
If using a reverse proxy (e.g., Synology Application Portal or NGINX), map / to port 8080.

3.3 KiB Raw Blame History Unescape Escape