CLI API Reference

The following commands are available in the CLI

Init

Create a new Railway project.

Running init will prompt you to create a new project or a select from one of our Starter Templates.

Connect to an existing Railway project.

Running link with no project ID will prompt you to select an existing project from your Railway account.

Run

Run a command using the Railway environment.

This injects all environment variables associated with the plugins you have installed in your project. If you run railway run without specifying a command, it will try to run the Dockerfile in the current directory, if it can find one.

Environment

Change which environment you are using. View environment docs for more information.

Status

View the status of your Railway project and user.

Variables

View all the environment variables associated with your project and environment.

Open

Open your current Railway project in the browser.

Login

Login to your Railway account.

This will open the browser to https://railway.app/cli-login.

Browserless

If you are in an environment where the terminal cannot open a web browser, (i.e. SSH session or Codespaces), you can perform a browserless login.

This will prompt you to go to a URL (you can copy and paste) and present you with a 4 word code that you need to verify. If the codes match, click "Verify" and you will be logged in

Logout

Logout of your Railway account.

Whoami

View what user is currently authenticated with Railway

Up

Deploy the current directory to your Railway project. The currently selected environment is used.

Disconnects the current directory from Railway. You will need to rerun railway init to use railway in this directory again.

Connect

Lets you connect to your Railway plugins.

If you don't specify a plugin, you will be prompted to select a plugin to connect to.

Supported:

  • postgresql/postgres/psql
  • mysql
  • redis
  • mongodb/mongo

Edit this file on GitHub