* fix(transit): lead arrive-by results with the latest arrival (#1479) MOTIS returns arrive-by itineraries ascending with the deadline-adjacent connection last, so the visible top of the list arrived ~2h before the requested time — misread as a timezone bug. Sort arrive-by results by endTime descending so the connection closest to the requested arrival leads, mirroring depart-by. Claude-Session: https://claude.ai/code/session_01BCrZUoPzHZF6H4C6avMXoz * fix(transit): lead arrive-by results with the latest arrival (#1479) MOTIS returns arrive-by itineraries ascending with the deadline-adjacent connection last, so the visible top of the list arrived ~2h before the requested time — misread as a timezone bug. Sort arrive-by results by endTime descending so the connection closest to the requested arrival leads, mirroring depart-by. * fix(reservations): run AirTrail modal hooks before the isOpen early return (#1602) The sectionItems useMemo added by #1535 sat below 'if (!isOpen) return null'. The modal mounts closed, so the first open render executed one more hook than the previous render and React unmounted the whole tree (error #310), blanking the page. Move the memo above the early return and cover the closed-then-open transition with a regression test. * fix(planner): only draw the check-in-day hotel morning leg when provably at/after check-in (#1597) (#1607) On an accommodation's check-in day the hotel -> first-stop leg was drawn by default for any PLACE first stop, suppressed only when that place was explicitly timed before check-in. An un-timed first place (e.g. "Home" on day 1 of a driving holiday) therefore always produced a phantom hotel -> Home leg, regardless of the check-in time. Flip the default to mirror shouldDrawEveningLeg: the morning leg is now drawn only when the first place is provably timed at/after check-in (you dropped your bags first). The drawn map route, the sidebar hotel connectors, and the Google Maps export all share this helper and inherit the fix. The optimizer anchors (#1321) are unchanged. * fix(notifications): never fall back to the admin ntfy topic for per-user sends (#1608) * chore: correct shields.io url * chore: correct shields.io url * chore: update helm repo link * chore: document new helm chart url * chore: document new helm chart url * fix(atlas): make Kosovo selectable on the Atlas map (#1609) Kosovo's user-assigned ISO code (XK/XKX) was missing from both code tables in the atlas pipeline: the geo builder's A3_TO_A2 map (so the shipped admin0 bundle carried ISO_A2: null) and the client's A2_TO_A3 map. With neither resolvable, onEachFeature attached no hover/click handlers to Kosovo's polygon and the country search dropped it, making Kosovo impossible to select. - add XK<->XKX to the client A2_TO_A3 table and the builder A3_TO_A2 map - stamp ISO_A2: "XK" on the Kosovo feature in the shipped admin0 bundle - guard both with tests (atlasModel resolution + ATLAS-BUNDLE-003) * chore: normalize docker image references to mauriceboe/trek (lowercase) * fix(memories): honor Synology skip-SSL on photo streaming (#1611) The synology_skip_ssl setting was forwarded on the JSON API path (login/browse/test-connection) but not on the image-byte fetches, so a NAS with a self-signed certificate passed Test Connection while /api/photos/:id/thumbnail and /original failed with 500 "Failed to fetch asset" — and the TLS error was silently swallowed. - pipeAsset: accept fetchOptions and forward to safeFetch; log the underlying error on the 500 path (without the URL, which carries _sid) - fetchSynologyThumbnailBytes / streamSynologyAsset: pass rejectUnauthorized derived from synology_skip_ssl; log on failure - i18n: replace hardcoded "Immich" with {provider_name} in 7 memories keys across 14 locales (source of the reported "Failed to connect to Immich" banner on the Synology test), fix translated placeholder names in tr/ca/pl, and add a placeholder-parity spec to prevent regressions - client: gallery provider badge matched 'synology' instead of the real id 'synologyphotos', showing the raw id; label is now "Synology Photos" * chore: make chart.liketrek.com the canonical helm chart url * feat(plugins): prefer the registry's resolved store screenshot (#1613) Browse/detail use the screenshotUrl the aggregate step resolves (cover at the latest commit, or the first resolving README image), falling back to the docs/screenshot.png guess when the field is absent. Fixes blank store cards for plugins without a committed docs/screenshot.png. --------- Co-authored-by: Maurice <61554723+mauriceboe@users.noreply.github.com>
5.4 KiB
Updating
How to update TREK to a newer version without losing data.
Before You Update
Back up your data first. Go to Admin Panel → Backups and create a manual backup, or copy your ./data and ./uploads directories to a safe location. See Backups for details.
Image Tags
| Tag | Example | Behavior |
|---|---|---|
latest |
mauriceboe/trek:latest |
Always the newest release across all major versions |
| Major version | mauriceboe/trek:3 |
Latest release pinned to that major version |
| Full version | mauriceboe/trek:3.4.0 |
Exact release; never changes |
Use latest or a major-version tag if you want updates on each redeploy. Use a full version tag for explicit control — update by changing the tag, not by re-pulling.
Docker Compose (Recommended)
latest or major-version tag:
docker compose pull && docker compose up -d
This pulls the newest matching image and recreates the container with your existing volumes. Your data is untouched.
Pinned full-version tag:
Edit docker-compose.yml, update the tag in the image: line (e.g. 3.4.0 → 3.4.1), then redeploy:
docker compose up -d
Docker Run
If you started TREK with docker run, pull the new image and replace the container:
docker pull mauriceboe/trek
docker rm -f trek
docker run -d --name trek -p 3000:3000 \
-v ./data:/app/data \
-v ./uploads:/app/uploads \
-e ENCRYPTION_KEY=<your-key> \
--restart unless-stopped \
mauriceboe/trek
Tip: Not sure which volume paths you used? Check before removing:
docker inspect trek --format '{{json .Mounts}}'
Helm (Kubernetes)
⚠️ Chart repository moved: The Helm chart is no longer served at
https://mauriceboe.github.io/TREK(the project moved from a personal repo to theliketrekorganization). The canonical chart URL is nowhttps://chart.liketrek.com— a custom domain (CNAME) for the GitHub Pages site athttps://liketrek.github.io/TREK, so it stays stable even if the repository moves again. If yourtrekrepo still points to an old URL, switch it before updating:helm repo remove trek helm repo add trek https://chart.liketrek.comYou can check which URL you have configured with
helm repo list. Existing releases are unaffected — only the repo URL changes.
To update to the newest chart release:
helm repo update
helm upgrade trek trek/trek
Your existing values and PVCs (data, uploads) are preserved. To pin an exact chart version instead, pass --version <x.y.z>.
See Install-Helm for the full installation walkthrough and values reference.
Database Migrations
TREK runs any pending database migrations automatically at startup. No manual migration steps are required after pulling a new image.
Encryption Key Note
If you are upgrading from a version that predates the dedicated ENCRYPTION_KEY (i.e. you have no ENCRYPTION_KEY environment variable set), TREK automatically falls back to ./data/.jwt_secret on startup and immediately promotes it to ./data/.encryption_key. No manual steps are required — the transition is handled at first boot after the upgrade.
If you want to rotate to a new key at any point (not required for a normal update), see Encryption-Key-Rotation for the full procedure.
Proxmox VE (LXC)
If you installed TREK via the Proxmox VE Community Scripts, run the following command inside the LXC container and select Update when prompted:
bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/trek.sh)"
Tip: Always check the community-scripts TREK page to confirm the latest command before running.
The script stops the service, backs up your data and uploads, applies the new release, restores the backup, and restarts. No manual steps required.
To verify the update completed and check for errors:
# Inside the container (pct enter <id> from the Proxmox shell)
journalctl -u trek -n 50
Portainer
Open the Stacks list, click the TREK stack, then click Redeploy.
latest or major-version tag — enable the Re-pull image and redeploy switch before confirming. Portainer pulls the newest matching image and recreates the container.
Pinned full-version tag (e.g. 3.4.0) — edit the stack, update the tag in the image: line, then click Update the stack. No re-pull switch needed; the tag change forces a fresh pull.
See Install-Portainer for the full installation walkthrough.
Unraid
In the Unraid Docker tab, click the TREK container and select Update. Unraid will pull the latest image and restart with the same volumes.
Next Steps
- Backups — schedule automatic backups so you always have a restore point before updates
- Encryption-Key-Rotation — if you need to rotate or migrate the encryption key
- Install-Docker-Compose — switch to Compose for easier future updates


