Guides · hosting · Everyday developer services

Railway project and tokens

Create a Railway account, pass the automated trial verification, create a project with the Railway CLI, and create a project or account/workspace token for CI.

Researched · not yet run liveLast researched 25 October 2026 · Railway · provider site

Researched, not yet run live. Built from the provider’s official pages (linked below). A person hasn’t walked this flow end to end yet, so check each step against the source.

Who owns what

A Railway account can belong to workspaces; projects contain environments and services.

  • Railway account personal owned by the person
  • Workspace organisation · under Railway account
  • Project project

Steps

Steps marked “human step” are ones only you can do: verapli never signs in, submits, pays or accepts terms for you.

  1. Create or sign in to a Railway account

    The person signs up or signs in at railway.com. verapli never creates the account.

    • Guided by hand
    • Human step: You press submit

    Where: https://railway.com/login

  2. Get the trial verified

    Connect a GitHub account to start Railway's automated verification. Unverified accounts run in a Limited Trial with restricted outbound network access and ports.

    • Guided by hand
    • Human step: The provider reviews it
    • After: Create or sign in to a Railway account
    The provider says
    Verification is fully automated and Railway does not respond to verification requests. [3]
    If something goes wrong (1)
    • Account stays on Limited Trial (GitHub account judged too new or inactive).: Upgrade to the Hobby plan to unlock full access; Railway will not review manually. [3]
  3. Create the project

    Install the Railway CLI, run railway login (railway login --browserless on a machine without a browser), then railway init to create a project or railway link for an existing one.

    • Guided by hand
    • Human step: You sign in
    • After: Create or sign in to a Railway account
  4. Create a project token for deploys

    In the project settings tokens page, create a token for one environment. verapli captures it into RAILWAY_TOKEN.

    • Guided by hand
    • Human step: You press submit
    • After: Create the project
  5. Create an account or workspace token (optional)optional

    On railway.com/account/tokens create an account token (all workspaces) or a workspace token (one workspace) for account-level automation. verapli captures it into RAILWAY_API_TOKEN.

    • verapli co-pilot
    • Human step: You press submit
    • After: Create or sign in to a Railway account

    verapli captures RAILWAY_API_TOKEN here by plain code: encrypted in your browser, never shown to AI.

    Where: https://railway.com/account/tokens

Terms and gotchas

Plain-English summary, not legal advice. Each card links its source.

Can cost moneyThe rules say

The trial is 30 days with a one-time $5 grant; after that the account drops to the Free plan with $1 of credit per month, which does not roll over. [3]

Worth knowingThe rules say

Account tokens can reach every workspace; prefer workspace or project tokens for CI. [2]

What you end up with

Env varSecretFormatWhat it is
RAILWAY_TOKENsecretProject token, scoped to one project environment (sent as Project-Access-Token header).
RAILWAY_API_TOKENsecretAccount or workspace token for account-level CLI and API actions (Bearer).

Pricing

  • Free tier: 30-day trial with $5 one-time credit (1 GB RAM, shared vCPU, 5 services per project), then Free plan with $1 credit per month.

Source [3]

For agents

The same entry as JSON: /api/v1/entries/railway/project · requirements /api/v1/requirements/railway/project · terms /api/v1/terms/railway/project.

Remote MCP (read-only, no auth)
claude mcp add --transport http verapli https://verapli.com/mcp

> "What do I need for Railway project and tokens, and how long will it take?"
  → tools/call requirements { "provider_id": "railway/project" }

Sources

  1. Railway CLI railway login (and --browserless), railway init creates a project, railway link links an existing project; RAILWAY_TOKEN is a project token for project-level actions; RAILWAY_API_TOKEN is an account/workspace token for account-level actions. · accessed 25 October 2026 · official
  2. Railway public API Account, workspace, project and OAuth token types and scopes; account and workspace tokens at railway.com/account/tokens; project tokens in project settings; Authorization Bearer vs Project-Access-Token header. · accessed 25 October 2026 · official
  3. Railway free trial 30-day trial with one-time $5 grant, 1 GB RAM, shared vCPU, 5 services per project; then Free plan with $1 credit per month; automated verification via GitHub account age/activity; unverified Limited Trial has restricted outbound network and ports; Railway does not respond to verification requests. · accessed 25 October 2026 · official
  4. Stripe Projects provider catalogue Railway is listed in the Stripe Projects catalogue as railway/hosting (Hosting, Database, Cache, Storage). · accessed 25 October 2026 · official

Provider rules change. This page is generated from verapli registry version 2026.1025.387; spotted something out of date? Tell us. Railway is not affiliated with verapli.