Use the Railway CLI to connect your code to your projects infrastructure without needing to worry about environment variables or configuration.

Install with Brew, NPM or Scoop.

brew install railwayapp/railway/railway

npm i -g @railway/cli

sh -c "$(curl -sSL https://raw.githubusercontent.com/railwayapp/cli/master/install.sh)"

Use this method if you prefer to interact with Railway using a native Windows binary.

scoop bucket add railway https://github.com/railwayapp/scoop-railway; scoop install railway/railway

For additional documentation on Scoop, see here.

You can also download the prebuilt binary directly or build from source.

Login to your Railway account. Opens a browser tab which authenticates into an existing Railway session.

railway login

If there are any issues with Browser based login you can use the --browserless flag to authenticate.

You can use Project tokens to authenticate in environments that prevent you to authenticate with browsers such as CI environments.

Project tokens allow the CLI to access all the environment variables associated with a specific project and environment. Use the token by setting the RAILWAY_TOKEN environment variable and then running railway run.

RAILWAY_TOKEN=XXXX railway run

Link to an existing Project under your Railway account or team.

railway link <projectId>

Create a new project directly from the command line.

railway init

Run code inside your Railway environment. We connect your code to your infrastructure hosted on Railway by injecting environment variables.

railway run <cmd>

For example, to run your node project with Railway:

railway run npm start

If you have a Dockerfile in your project directory, you can just run railway run with no arguments to build and run the Dockerfile.

Projects might have multiple environments, by default the CLI points to the production environment. If you'd like to use a different set of environment variables and a different deployment environment you can change the setting by:

railway environment

Deploy current directory to Railway. Displays deployment logs from the project deploys.

railway up

Provision a plugin for a project.

railway add

Open an interactive shell to a database directly in the CLI.

railway connect

railway logout