Replace the social media feed with private, self-hosted digital postcards for the people you actually want to keep in the loop.
Website · Install · Operations guide · Configuration guide · Report a problem · Contribute
Postmarked is a lightweight travel journal for sharing photos, videos, stops, and updates with family and friends. It works for road trips, long weekends, international travel, full-time travel, and any journey worth remembering.
- Your trip, not an algorithm. Visitors follow a chronological story instead of a social feed designed to hold their attention.
- Public or private sharing. Choose who can see each trip and let subscribers receive email notifications when you post.
- Simple publishing. Sign in, create a trip, add stops and updates, and let people follow along.
- Self-hosted and portable. Run Postmarked with Docker, keep control of the data, and use the built-in export, restore, and migration tools.
Postmarked also includes photo and video galleries, current-stop weather, customizable site text, user approval controls, optional single sign-on, and RV Trip Wizard import.
Trip page · Gallery · Post editor
Postmarked requires Docker with Compose. Download the Compose file and example environment:
curl -fLO https://raw.githubusercontent.com/Backroads4Me/postmarked/main/compose.yaml
curl -fLo .env https://raw.githubusercontent.com/Backroads4Me/postmarked/main/.env.exampleEdit .env and set production values for SECRET_KEY, APP_BASE_URL,
ADMIN_EMAIL, ADMIN_PASSWORD, and POSTGRES_PASSWORD. Then start the stack:
docker compose up -dOpen http://localhost:4321/admin and sign in with the admin email and password
from .env.
- The operations guide covers storage, backups, restore, upgrades, and Cloudflare cache rules.
- The configuration guide covers RV Trip Wizard import, OpenID Connect, Google sign-in, and policy pages.
.env.exampledocuments the available deployment settings.
Bug reports, feature ideas, and pull requests are welcome. Use GitHub Issues to describe a problem or proposed behavior before starting a substantial change.
Postmarked is licensed under the GNU Affero General Public License v3.
Postmarked is free and open source. If it helps you share your travels, starring the repository helps other self-hosters find it.
