How do I deploy HappyView on Railway?

You can deploy HappyView 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: happy-view-8771ff24, or click "Get template help" for this template for more assistance.

Deploy and Host HappyView on Railway

HappyView is a lexicon-driven ATProto AppView. Upload lexicon definitions at runtime and HappyView dynamically generates XRPC query and procedure endpoints, indexes records from the network, and proxies writes to users' PDSes — no restart required.

About Hosting HappyView

Hosting HappyView requires a Postgres database, an AIP instance for OAuth 2.1 authentication, and a Tap instance for syncing records from the AT Protocol network. This template deploys all four services pre-configured to work together. After deployment, you'll need to assign public domains to HappyView and AIP, set your admin DID, and generate signing keys for AIP. See the quickstart guide for setup steps.

Common Use Cases

Building custom ATProto applications with their own record types and queries
Indexing and querying AT Protocol records without running a full relay
Hosting a backend for ATProto clients that need OAuth authentication and record management

Dependencies for HappyView Hosting

PostgreSQL 17+
AIP (ATProto Identity Provider) for OAuth 2.1 with PKCE and DPoP
Tap for syncing AT Protocol records from the network

Deployment Dependencies

HappyView documentation
AIP configuration guide (signing key generation)
AT Protocol specification

Why Deploy HappyView on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying HappyView on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.