Usertour

In-app product tours and user onboarding, honestly reviewed. No marketing fluff, just what you get when you self-host it.

TL;DR

• What it is: An open-source user onboarding platform — product tours, checklists, surveys, popups, and launchers that live inside your app [README].
• Who it’s for: Product teams and technical founders building web apps who want Appcues-style in-app guidance without the $249+/mo SaaS bill, and who have someone who can handle a Docker deployment [2][README].
• Cost savings: Appcues, Userpilot, and Userflow all start at $249–$300/mo. Usertour self-hosted runs on a $5–10/mo VPS with no session caps [3][README].
• Key strength: The most complete visual builder in the open-source onboarding space — no other self-hostable option gives you a WYSIWYG editor, theming, analytics, segmentation, multi-environment support, and a launcher in one package [2][README].
• Key weakness: The license is custom (a “SAAP Agreement,” not MIT or Apache), the project sits at under 2,000 GitHub stars, and there’s almost no third-party coverage to validate the production experience at scale [README][merged profile].

---

What is Usertour

Usertour is a self-hostable user onboarding platform. You embed a JavaScript snippet in your web app, then use Usertour’s visual editor — running in your browser, pointed at your live app — to build guided flows: step-by-step product tours, checklists, popup announcements, inline surveys, and launcher widgets. The whole thing runs on your server, pointed at your database, logging to your infrastructure [README].

The project describes itself as “the open-source alternative to Appcues, Userflow, Userpilot, Userguiding, Chameleon” [README]. That’s a bolder claim than the typical self-hosted tool makes, because those are fully-staffed product companies with dedicated onboarding UX teams. But the feature list is closer to that category than you might expect: multiple environments, version history for flows, custom user attributes, automated triggers, multi-language support, and per-user analytics are all present [README][homepage].

The tech stack is React, TypeScript, Tailwind CSS, shadcn/ui, PostgreSQL, and Prisma [homepage]. That’s a 2024-era modern web stack, not a PHP monolith, which matters for long-term maintainability. Docker Compose is the primary deployment path, with a one-click Railway template available for teams that don’t want to manage a VPS [README].

GitHub shows 1,947 stars at time of writing. The project launched its v0.2.x releases in 2025, with the creator actively posting updates in r/selfhosted and crediting community feedback directly [5][merged profile].

---

Why people choose it

The honest answer is: the comparison set for self-hosted user onboarding is thin. Most open-source tools in this space are JavaScript libraries — you get a npm install and write your own tour logic in code. Shepherd.js, Driver.js, Intro.js, React Joyride — these are great for shipping a quick “first-run” overlay, but they don’t give you a visual editor, analytics, or a way for a non-developer to update the tour copy without a deploy [4][1].

Usertour is trying to be something different: a full platform, not a library. That matters because the person updating onboarding copy is usually a product manager, not an engineer. With library-based tools, every copy change requires a code change, a PR, a review, a deploy. With Usertour, it’s a WYSIWYG edit [2][README].

The Userpilot review roundup [2] positions it clearly: “UserTour: Best for teams that want a full onboarding platform with a visual builder.” That framing is accurate — it’s the only self-hosted option in that review that clears the bar of “full platform with visual builder” rather than “developer library.”

Versus Appcues, Userpilot, Userflow. These are the commercial alternatives Usertour most directly replaces. Userflow starts at $300/month [3]. Userpilot and Appcues are similarly priced at $249+/mo. All three are black-box SaaS: your flow data, your user session data, and your onboarding logic live on someone else’s server. Self-hosting Usertour on a $6 VPS eliminates that recurring cost and keeps data in-house [3][README].

Versus UserGuiding. UserGuiding starts at $89/month and is more accessible for small teams [3]. It’s still closed-source SaaS. If the reason you’re looking at open source is data privacy — a common trigger in regulated industries — UserGuiding doesn’t solve it. Usertour does.

Versus Shepherd.js, Driver.js, Intro.js. The library comparison from [4] is where it gets interesting. Those tools are free (MIT-licensed), well-maintained, and widely used. But they top out fast: you get tooltips and basic tour step logic. When you need targeting (show this flow only to users who haven’t completed feature X), analytics (what step do users abandon?), localization, or checklists, you’re building those yourself on top of the library. That’s engineering time that accumulates [4][1]. One Userpilot article [1] puts it plainly: open-source libraries “typically don’t include no-code editors, deep analytics, audience segmentation, A/B testing, or omnichannel engagement.” Usertour closes most of those gaps.

---

Features

Based on the README, homepage, and release notes:

Core onboarding elements:

• Product tours with step-by-step tooltip/modal flows [README]
• Checklists with auto-dismiss when all items complete [5]
• Popup announcements and banners [homepage]
• Surveys embedded in flows [README]
• Launcher widgets (the floating button pattern that opens a menu of available tours) [homepage]

Builder and editor:

• Visual WYSIWYG editor — point-and-click on your live app to create steps [README][homepage]
• Rich content editor: text, links, images, videos, user attribute variables [homepage]
• Works with any browser-based framework — React, Vue, Angular, plain JS [README]
• Multi-page app support [README]

Targeting and personalization:

• Custom user attributes for segmenting audiences [README][homepage]
• Event tracking to trigger flows based on user actions [homepage]
• Automated trigger rules: on signup, on page visit, on feature activation [homepage]
• Multi-language support — create one flow, localize only the text that differs [homepage]

Theming:

• Full theme customization: colors, fonts, button styles [README]
• Multiple themes per account — different visual styles for different flows [homepage]

Analytics:

• Flow-level metrics: views, completion rates [README]
• Step-level drop-off analysis — see exactly where users exit [homepage]
• User-level session history [5]
• Company-level session views (see all members of an org) [5]

Environments and versioning:

• Multiple environments (Production, Staging) in one account [README]
• Version history per flow — see who changed what and when [README]

Infrastructure:

• Docker Compose deployment [README]
• Railway one-click deploy template [README]
• REST API [merged profile]

Custom progress indicator styles were added in v0.2.6: thin lines, dots, numbered steps, or “chain” style [5].

---

Pricing: SaaS vs self-hosted math

Usertour Cloud (their SaaS): The pricing page exists but specific tier prices aren’t published in the scraped data. The homepage FAQ mentions sessions as a metered unit (“What if I run out of sessions?”) and branding removal as a paid feature (“Can I remove the ‘Made with Usertour’ branding?”). The free tier is advertised with “no credit card required.” A commercial license is available, with the FAQ explicitly asking “Why should I choose a Commercial license when an Open Source license is available?” — data on specific prices is not publicly listed in the scrape.

Self-hosted:

• License cost: depends on interpretation (see licensing note in Cons section)
• VPS: $5–10/mo on Hetzner, Contabo, or DigitalOcean
• PostgreSQL and Redis: bundled in the default Docker Compose

The commercial alternatives, for comparison [3]:

• UserGuiding: $89/mo
• Appcues: ~$249/mo
• Userpilot: ~$249/mo
• Userflow: $300/mo

Concrete savings math:

Say you’re a small SaaS with 500 monthly active users who need onboarding. UserGuiding at the entry tier would run you ~$89/mo. Over 12 months that’s $1,068. Self-hosted Usertour on a $6 Hetzner VPS: $72/year. The delta is roughly $1,000/year — meaningful for early-stage teams.

At the Appcues/Userpilot tier, the math gets sharper: $249/mo = $2,988/year versus $72/year self-hosted. That’s $2,900/year back in your budget — if you can handle the Docker deployment.

The catch: those commercial platforms include customer support, uptime guarantees, and someone to call when something breaks. Self-hosted means you’re on the hook for maintenance, updates, and debugging. Factor that into the math honestly.

---

Deployment reality check

The README’s install path is Docker Compose with a .env file from .env.example:

cp .env.example .env
docker compose up -d

Visit http://localhost:8011 and you’re running. That’s the fastest documented path for any full-stack onboarding platform in this space [README].

What you actually need:

• A Linux VPS (the Railway template suggests the project runs fine in containerized cloud environments)
• Docker and docker-compose
• PostgreSQL (bundled in the default compose)
• A domain and reverse proxy (Caddy or nginx) if you want HTTPS
• SMTP if you need user notification emails
• The Railway one-click template if you want to skip VPS management entirely

What can go sideways:

The project is young — 1,947 stars, active development in 2025, no third-party “I’ve run this in production for 18 months” write-ups in the reviewed sources. The r/selfhosted thread [5] is the creator posting their own update, not a community member reporting a two-year production run. That’s not a criticism of the code quality — it’s a calibration of how much external validation currently exists.

The NOASSERTION license value in the merged profile is a flag worth investigating. The website links to /legal/Usertour-SAAP-License-Agreement.pdf — “SAAP” appears to stand for their custom licensing arrangement. Before deploying this for a client or embedding it in a commercial product, read that PDF. This is not MIT. The FAQ phrase “Why should I choose a Commercial license when an Open Source license is available?” implies the open-source path has restrictions that matter for commercial use.

Realistic setup time: 30–60 minutes for someone comfortable with Docker and DNS. 2–4 hours for a first-timer including the reverse proxy and SSL setup. The Railway template cuts this to under 10 minutes if you’re willing to pay for Railway hosting instead of managing a VPS.

---

Pros and cons

Pros

• Most complete self-hosted onboarding platform available. No other self-hostable tool combines a visual builder, analytics, segmentation, theming, checklists, surveys, launchers, and environments in one package [2][README].
• Non-developers can update flows. The WYSIWYG editor means product managers can change tour copy, add steps, and update targeting rules without writing code or opening a pull request [README][homepage].
• Multi-environment support. Production and Staging environments in a single account is a professional feature that most library-based tools simply don’t offer [README].
• Version history per flow. Seeing who changed what and when matters when multiple people are editing onboarding flows [README].
• User-level and company-level session analytics. Not just aggregate completion rates — you can drill into a specific user’s journey [5][homepage].
• Modern stack. React, TypeScript, Prisma, PostgreSQL. Easy to read, contribute to, or fork [homepage].
• Active development. v0.2.6 in 2025 shows consistent shipping: custom progress indicators, auto-dismiss checklists, segment filtering fixes, UI polish throughout [5].
• Railway one-click template for teams that don’t want to manage infrastructure [README].

Cons

• License is not MIT. The NOASSERTION flag in the repo metadata and the presence of a custom “SAAP License Agreement” PDF on the website means you need to read the legal terms before using this commercially. Do not assume “open-source” means “freely commercial” here [merged profile][homepage].
• Under 2,000 GitHub stars. The project is early-stage. Appcues and Userpilot have been in market for a decade. There’s limited third-party production evidence, no major tech publication reviews, and a small community [merged profile][5].
• Cloud pricing is opaque. The pricing page doesn’t show tier prices clearly in the public scrape. The session-based limit model (and branding removal as a paid feature) suggest a freemium structure, but you can’t easily compare it to competitors without contacting sales or signing up [homepage].
• “Made with Usertour” branding on the free tier. The FAQ question about removing it implies it’s visible by default in the free/open-source version. For white-label deployments, that matters [homepage].
• Almost no third-party reviews. The r/selfhosted thread [5] is the creator’s own post. The Userpilot roundup [2] gives it one line. Marketer Milk’s roundup [3] doesn’t mention it. That’s a thin validation base compared to tools like Shepherd.js or commercial competitors.
• No documented community scale story. No case studies, no “we onboard 50K users/month through Usertour self-hosted” data points. You’re somewhat first-mover if you deploy this in production today.
• No SSO or RBAC documented for the open-source version. Team governance for larger orgs isn’t addressed in the public docs.

---

Who should use this / who shouldn’t

Use Usertour if:

• You’re building a web app and paying $89–$300/mo for Appcues, Userpilot, or Userflow — and want that money back.
• You need a non-technical product manager to own onboarding flows without engineering involvement.
• You’re in a regulated industry where user session data going through a third-party SaaS is a compliance concern.
• You’re comfortable with Docker and can deploy a basic VPS setup, or you’ll use the Railway template.
• You’re an early-stage startup that wants enterprise-grade onboarding infrastructure on a $10/mo infrastructure budget.

Skip it (use a library like Shepherd.js or Driver.js instead) if:

• Your onboarding needs are simple — one or two static guided tours that engineers will maintain anyway [4].
• You want MIT-licensed, dependency-light code you can read, fork, and own unconditionally.
• You don’t need a visual editor or analytics dashboard.

Skip it (stay on Appcues or Userpilot) if:

• You need enterprise SSO, audit logs, and dedicated support SLAs.
• Your compliance team won’t approve self-hosted infrastructure.
• You’re currently on a free tier of one of those tools and the cost isn’t a problem yet.

Skip it (investigate further first) if:

• The custom license is a blocker for your legal team — get clarity on the SAAP agreement before committing.
• You need production stability evidence before betting your onboarding on a tool: wait 6–12 months for more community validation.

---

Alternatives worth considering

• Shepherd.js — MIT-licensed, framework-agnostic, excellent for code-controlled product tours. No visual editor, no analytics, no platform features. Right for engineering-led teams that want full code control [4].
• Driver.js — Tiny, MIT-licensed, spotlight and tooltip-focused. Even simpler than Shepherd.js. Best for a single guided highlight, not a full onboarding system [4].
• Intro.js — Established, widely used, but AGPL license means commercial apps require a paid license (Starter $9.99, Business $49.99, Premium $299.99 one-time). Development activity has slowed [1][4].
• React Joyride — Best free option for React-only apps with simple tour requirements [2]. No visual editor.
• Onborda — Purpose-built for Next.js apps using Tailwind CSS and shadcn/ui [2][4]. Very specific stack requirement.
• Appcues / Userpilot / Userflow — The commercial incumbents. $249–$300/mo, fully managed, no self-hosting option, but battle-tested and with full support contracts [3].
• UserGuiding — The most affordable commercial option at $89/mo [3]. Still closed-source SaaS, but a reasonable middle ground if self-hosting is too much operational overhead.
• ChiefOnboarding — Open-source, but focused on employee onboarding (HR workflows, Slack integration), not in-app product tours [2].

For a non-technical founder or product manager who wants to escape SaaS billing, the realistic shortlist is Usertour vs UserGuiding. Usertour if you have someone to handle Docker and want zero recurring SaaS cost. UserGuiding if you need something running in 20 minutes with no infrastructure.

---

Bottom line

Usertour is the only self-hostable tool that competes directly with the Appcues tier of commercial onboarding platforms — visual builder, analytics, segmentation, theming, checklists, surveys, and launcher widgets in one place. If you’ve been paying $249/mo for Userpilot and the only reason is that you haven’t found a self-hosted alternative worth betting on, Usertour is now worth evaluating seriously. The trade-offs are real: the project is young, third-party production evidence is thin, and the license needs a closer read before any commercial deployment. But the feature set is genuine, the stack is solid, and the development cadence is active. For a technical founder who can run Docker and is tired of per-seat SaaS pricing for onboarding software, it’s the most credible option currently available in the self-hosted space.

If deploying and maintaining it yourself is the blocker, that’s exactly what upready.dev handles for clients — one-time setup, you own the infrastructure.

---

Sources

1. Userpilot Team, Medium — “Best Free Open Source User Onboarding Software (+ Alternative)” (Sep 12, 2025). https://userpilot.medium.com/best-free-open-source-user-onboarding-software-alternative-71877cccadaa
2. Abrar Abutouq, Userpilot — “Best Open Source User Onboarding Software in 2026: Honest Reviews for Product Teams” (March 27, 2026). https://userpilot.com/blog/open-source-user-onboarding/
3. Marketer Milk Team — “15 best user onboarding software you need to try in 2024” (September 30, 2024). https://www.marketermilk.com/blog/user-onboarding-software
4. Mukesh Swamy, Userorbit — “Best Open-Source Product Tour Libraries in 2026” (March 21, 2026). https://userorbit.com/blog/best-open-source-product-tour-libraries
5. Crafty_Impression_37, r/selfhosted — “Usertour v0.2.6 – Visual polish, smarter onboarding logic, and better session insights”. https://www.reddit.com/r/selfhosted/comments/1lzmlde/usertour_v026_visual_polish_smarter_onboarding/

Primary sources:

• GitHub repository and README: https://github.com/usertour/usertour (1,947 stars)
• Official website: https://www.usertour.io
• Pricing page: https://www.usertour.io/pricing
• Documentation: https://docs.usertour.io