Deploy on Railway Button

Railway makes it easy to deploy any public GitHub repo with the Deploy on Railway button. The button transforms any Railway Template into a 1-click deployable project.

Example README with Deploy on Railway button

Button

The button is located at https://railway.app/button.svg.

You can also copy the button below: https://railway.app/button.svg

The button should link to the desired template. Instructions are below for Starting with a New Template and Starting with an Existing Template.

Markdown

To render the button in Markdown, copy the following code and replace the link with your desired template.

HTML

To render the button in HTML, copy the following code and replace the link with your desired template.


Use Cases

Since the Deploy on Railway button generates a deterministic and reproducible deployment, it is an excellent way to share your project with the public and let others clone your project.

Use cases include the following:

  • README files
  • Tutorials and guides
  • Getting Started docs
  • Websites and social profiles

The button is also a way to take advantage of the Railway Open Source Kickback program, which provides open source maintainers a financial incentive to maintain templates on Railway.

Deploy on Railway Examples

Any Template on Railway can be made into a Deploy on Railway button.

Here are some example templates from the template gallery in button form:

IconTemplateButton
NodeNodeDeploy on Railway
DenoDenoDeploy on Railway
BunBunDeploy on Railway
SvelteKitSvelteKitDeploy on Railway
GinGinDeploy on Railway
FlaskFlaskDeploy on Railway
RailsRailsDeploy on Railway
DjangoDjangoDeploy on Railway
SinatraSinatraDeploy on Railway
LaravelLaravelDeploy on Railway

Requirements

The only requirement to create a Deploy on Railway button is to first create a template. Services within a template can point to any public repository.

Services can be specified with environment variables, and additional configuration options like a start command.

Starting with a New Template

To create a Deploy on Railway button, you'll first need a public template. We've made it easy to get everything you need at railway.app/button.

Screenshot of railway.app/button

This page is designed to guide you through the template creation process. The requirements are as follows:

  1. Template Name - Name the template
Deply on Railway Template Name
  1. Services - Specify one or multiple services
Deply on Railway Service
  1. Databases - Add the databases needed for the template
Deploy on Railway Database
  1. Demo Project - Choose a public project as a preview for the template
Deploy on Railway Demo

That's all there is to it!

Starting with an Existing Template

To start with an existing template, log in to the Railway Dashboard and visit https://railway.app/account/templates.

Deploy on Railway Template

From this page, you'll be able to create and share templates.

Deploy on Railway Template Details

Edit this file on GitHub