---
title: "Deploy Usertour"
description: "Usertour is an open-source user onboarding platform."
category: "Other"
url: https://railway.com/deploy/usertour-1
---

# Deploy Usertour

Usertour is an open-source user onboarding platform.

**[Deploy Usertour on Railway](https://railway.com/template/usertour-1)**

- **Creator:** Usertour Inc
- **Category:** Other
- **Total deploys:** 42

## Template content

### usertour

- **Image:** usertour/usertour
- **Health check:** /api/health
- **Public domain:** Yes

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:17

### Redis https://cdn.sanity.io/images/sy1jschh/production/0ce0bfdcfbdbf69662b1116671f97c2dd788b655-157x157.svg

- **Image:** redis:8.2.1
- **Start command:** `/bin/sh -c "rm -rf $RAILWAY_VOLUME_MOUNT_PATH/lost+found/ && exec docker-entrypoint.sh redis-server --requirepass $REDIS_PASSWORD --save 60 1 --dir $RAILWAY_VOLUME_MOUNT_PATH"`

### PgBouncer https://devicons.railway.app/i/postgresql.svg

- **Image:** railwayapp/pgbouncer:latest

## Documentation

[![Usertour](https://raw.githubusercontent.com/usertour/docs/main/images/hero-02.png)](https://www.usertour.io)

Usertour is an open-source user onboarding platform. Create in-app product tours, checklists, and surveys in minutes—effortlessly and with full control.

🌐 [Official Website](https://www.usertour.io) |
📖 [Documentation](https://docs.usertour.io) |
💻 [GitHub Repository](https://github.com/usertour/usertour)

---

# Features

Usertour helps you build in-app onboarding flows fast — including tours, checklists, launchers, and surveys. Fully customizable, analytics-ready, and framework-agnostic.

---

## Quick Start

This Railway template is ready to run with default settings. Just deploy and start exploring Usertour immediately.

> **Important**
>
> - Default configuration **does NOT include Email Service or Object Storage**
>   - ❌ Invitation & user registration emails will not work  
>   - ❌ Image uploads will not work  
>
> Configure required environment variables:  
> 👉 https://docs.usertour.io/open-source/env

---

## ⚠️ First-Time Setup

After deployment, you **must create the initial admin account immediately**:

👉 https://docs.usertour.io/open-source/system-admin#first-time-setup

- The first registered user becomes the **admin**
- Until this is done, the instance is **not secured**
- Anyone with access to the URL can take control

**Recommended:**

- Open your instance right after deploy  
- Create the admin account before sharing the URL  
- (Optional) Restrict access during setup  

> ⚠️ Do not expose your instance publicly before completing admin setup.

---

## Fully Customizable

- Customize text, colors, fonts, and layout
- Multiple themes supported

## Framework & Environment Support

- Works with all browser apps (SPA & multi-page)
- Target users via attributes and events
- Supports multiple environments (Prod / Staging)
- Built-in version tracking

## Analytics & Insights

- Track views, completions, and drop-offs
- Identify weak steps and improve onboarding

---

# Deploy and Host

Railway provisions Usertour with required services automatically.

---

## About Hosting

When self-hosting:

- Full data ownership
- No vendor lock-in
- You manage infra and backups
- AGPL v3 applies

---

## Common Use Cases

- Privacy-sensitive SaaS
- Internal tools
- Enterprise dashboards
- Isolated environments

---

## Dependencies

Required:

- PostgreSQL  
- PgBouncer  
- Redis  

Additional:

- Email Service (for invitations)  
- S3-compatible storage (for uploads)  

Env setup:  
👉 https://docs.usertour.io/open-source/env

## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — [Jul'26] Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — A Self-Hosted & Modern Roleplaying Platform
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

Open this page in a browser: https://railway.com/deploy/usertour-1