Railway
All agents

Windsurf + Railway

Windsurf is Codeium's agentic IDE featuring Cascade, an AI assistant that maintains context across multiple actions. The Flows feature enables complex, multi-step development tasks. Its terminal integration makes Railway deployments straightforward.

CLIWindsurf Docs

Quick start

1

Download Windsurf

Download Windsurf from Codeium

https://codeium.com/windsurf
2

Install Railway CLI

Install Railway CLI and authenticate in Windsurf's terminal

npm install -g @railway/cli && railway login
3

Create a deployment Flow

Use Cascade to create a Flow that runs: railway init → railway up → railway logs

4

Deploy a FastAPI app with MySQL

Cascade runs your Flow and deploys railway.com/template/fastapi with a MySQL service attached

Deploy a FastAPI backend with MySQL database to Railway

Example prompts

“Deploy this FastAPI project to Railway”

“Add a Postgres database and wire up the connection string”

“Create a Flow that deploys and monitors my service”

“Set up private networking between frontend and backend services”

“Configure persistent volumes for file uploads”

“Debug the memory leak shown in my Railway metrics”

“Deploy Metabase connected to my production Postgres for analytics”

“Set up NocoDB with MinIO for a no-code database UI with file storage”

“Deploy a Strapi CMS with Postgres and Cloudinary integration”

“Create an event-driven architecture with Redis Streams and multiple workers”

Common workflows

1Deploy a MariaDB database

  1. Ask Cascade to add MariaDB to your project
  2. Cascade creates the MariaDB service via CLI
  3. Cascade retrieves and sets DATABASE_URL
  4. Cascade updates your code with connection details

2Flow-based deployment

  1. Create a Flow for deployment tasks
  2. Cascade handles Railway CLI setup
  3. Automated deployment on code changes
  4. Cascade monitors and reports status

3Cascade-assisted debugging

  1. Ask Cascade to check deployment logs
  2. Cascade runs railway logs and analyzes output
  3. Cascade suggests fixes based on errors
  4. Apply fixes and redeploy with Cascade

4Multi-service orchestration

  1. Ask Cascade to set up multiple services
  2. Cascade creates service configurations
  3. Cascade sets up internal networking
  4. Deploy all services together

Tips for success

  • Use Flows to automate repetitive deployment tasks
  • Cascade remembers your Railway project context
  • Let Cascade suggest Railway commands based on your code

Frequently asked questions

How do I deploy to Railway using Windsurf Flows?

Create a Flow with steps for railway login, railway link, and railway up. Cascade will execute the entire deployment pipeline automatically.

Can Cascade help configure my Railway project?

Yes! Ask Cascade to create a railway.toml or set environment variables. It maintains context across your session so it understands your project setup.

How do I debug Railway deployment failures in Windsurf?

Ask Cascade to run railway logs and analyze the output. It will identify errors, suggest fixes, and can apply them directly to your code.

Troubleshooting

Issue:

Railway CLI not recognized in Windsurf terminal

Solution:

Install Railway CLI globally with npm install -g @railway/cli and restart Windsurf to refresh the PATH.

Issue:

Cascade loses Railway project context

Solution:

Use railway link at the start of each session to ensure Cascade knows which project to work with.

Issue:

Flow fails during deployment step

Solution:

Check individual Flow step logs. Ensure Railway CLI is authenticated with railway login before running Flows.

Community resources

Central StationDiscordWindsurf GitHubCodeium Discord

Ready to deploy with Windsurf?

Get started in minutes. Railway handles the infrastructure.

Start a new projectRead the docs