How do I deploy habittrove on Railway?

You can deploy habittrove on Railway by clicking the "Deploy Now" button on this page. Railway will automatically set up all the necessary services and configurations for you.

What are the system requirements?

Railway handles all the infrastructure requirements. You only need a web browser to deploy and manage your application.

Is this template free to use?

Yes, this template is free to use within your existing Railway account.

Can I customize this template?

Yes, you can fully customize this template. After deployment, you will have full control of what you've deployed in your Railway project.

How do I get support for this template?

You can get support through our community forum: habittrove-template-83d95075, or click "Get template help" for this template for more assistance.

Deploy and Host HabitTrove on Railway

About Hosting

HabitTrove is a self-hosted, open-source, gamified habit tracking application built with Next.js. It helps users create habits, track progress, earn coins for completions, and redeem those coins against a custom wishlist of rewards.

The official Docker image stores data in local JSON files under the container filesystem (/app/data) and creates rotating backups in /app/backups. On Railway, this template deploys the upstream image directly and mounts persistent storage to /app/data, which keeps user data and application state across restarts and redeploys.

Why Deploy

Gamified habit tracking — Turn daily habit consistency into a reward loop with coins and wishlist redemptions.
Simple architecture — One service, one Docker image, no external database required.
Upstream-first deployment — Uses dohsimpson/habittrove:latest without unnecessary command overrides.
Persistent app state — Railway volume mount at /app/data preserves habits, users, and settings.
PWA-ready UI — Mobile-friendly interface with progressive web app behavior from upstream.

Common Use Cases

Personal habit dashboard — Track routines (exercise, reading, journaling) with streaks and rewards.
Family accountability board — Run one instance for multiple users sharing progress and goals.
Private self-hosted alternative — Keep your habit and reward data under your own infrastructure.
Demo-ready setup — Optionally enable demo mode behavior via DEMO environment variable.

Dependencies for Deployment

Deployment Dependencies

Dependency	Details
Docker Image	`dohsimpson/habittrove:latest` (official upstream image)
Exposed Port	`3000`
Persistent Volume	Required at `/app/data` (stores JSON data files and app state)
`PORT`	Required — set to `3000` so Railway routes public traffic correctly
`AUTH_SECRET`	Required — cryptographic secret used by authentication/session logic
`DEMO`	Optional — enables demo-mode behavior when set to a non-empty value
External Database	None
Start Command Override	Not required (uses image default `CMD ["node","server.js"]`)