Turso + Railway

Prerequisites

Before you start, make sure you:

Retrieve database credentials

You will need an existing database to continue. If you don’t have one, create one.Get the database URL:

turso db show --url <database-name>

Get the database authentication token:

turso db tokens create <database-name>

Assign credentials to the environment variables inside .env.

TURSO_DATABASE_URL=
TURSO_AUTH_TOKEN=

You will want to store these as environment variables.

Get application code

Fork and clone the following embedded replica project from GitHub locally:

See the full source code

See the full source code

Create a new Railway project

Run the following command to create a new Railway project. Provide the project’s name when prompted.

railway init

Add a service to the Railway project

Create a new empty service on your Railway project to act as your app’s deployment target.

Link application to service

Run the following command to list and select the service to link to your application:

railway service

Add database credentials

Open the service on your Railway dashboard and add your Turso Cloud database credentials.

TURSO_DATABASE_URL=libsql://[db-name]-[github-username].turso.io
TURSO_AUTH_TOKEN=...
LOCAL_DB=file:local-db-name.db

Deploy

Run the following command to deploy your application:

railway up

Make sure you expose your application to the internet to make it accessible from the public network.

If you are on a free plan, you’ll need to connect your Railway account to GitHub to have access to code deployments.