Embedded Replicas on Fly

You should have an application ready using your Turso database that you want to deploy to Fly.

Using the Fly CLI, launch it:

fly launch

Your application will automatically deploy to Fly, but we’re not ready yet.

Now create a volume that will be used to store the embedded replica(s):

fly volumes create libsql_data

The files fly.toml and Dockerfile created created when you launched previously.

Update fly.toml this file to mount the new volume:

[[mounts]]
source = "libsql_data"
destination = "/app/data"

Then inside Dockerfile, make sure you install and update ca-certificates:

RUN apt-get update -qq && \
    apt-get install -y ca-certificates && \
    update-ca-certificates

Make sure to also add the following line after any COPY commands to copy the certificates:

COPY --from=build /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/

You will want to change the url to point to a local file, and set the syncUrl to be your Turso database URL:

import { createClient } from "@libsql/client";

const client = createClient({
  url: "file:./local.db",
  syncUrl: process.env.TURSO_DATABASE_URL,
  syncToken: process.env.TURSO_AUTH_TOKEN,
  syncInterval: 60000,
});