> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fly.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Speedrun: Add LiteFS to your app

This guide will get your app up and running with LiteFS on Fly.io as
fast as possible. If you run into any issues with this guide, or you'd like
some more details or a slower pace, check out the [Getting Started doc][] instead.

You can also take a look at [the docs for your framework][Framework docs]
to see if LiteFS is supported by `fly launch`.

<Info>
  This guide assumes you already have a working `Dockerfile` for
  your app. If not, get that working (with regular sqlite), and then come
  back here!
</Info>

[Getting Started doc]: /litefs/getting-started-fly

[Framework docs]: /languages-and-frameworks

<h2 id="lets-do-this">
  Let's do this!
</h2>

### 1. Configure litefs.yml

Copy [the sample `litefs.yml` file](https://github.com/superfly/litefs-example/blob/main/fly-io-config/etc/litefs.yml)
from the `litefs-example` repo, and make the following updates:

* Update from `8081` in `proxy.target` to whatever port your app listens on
* Update `exec[0].cmd` to the command that runs your app

### 2. Update your Dockerfile

Install LiteFS dependencies:

```dockerfile theme={null}
# for alpine-based images
RUN apk add ca-certificates fuse3 sqlite
# or for debian/ubuntu-based images
RUN apt-get update -y && apt-get install -y ca-certificates fuse3 sqlite3
```

Copy in the LiteFS binary:

```dockerfile theme={null}
COPY --from=flyio/litefs:0.5 /usr/local/bin/litefs /usr/local/bin/litefs
```

Update the `ENTRYPOINT` (or `CMD`):

```dockerfile theme={null}
ENTRYPOINT litefs mount
```

<h3 id="3-set-up-amp-deploy-to-the-fly-platform">
  3. Set up & deploy to the Fly Platform
</h3>

Create a volume:

```sh theme={null}
fly volumes create litefs --size 10
```

Create your app config, but don't deploy it (say no when it asks):

```sh theme={null}
fly launch
```

Configure consul (this sets the `FLY_CONSUL_URL` secret for your app, which is required for LitefS leases):

```sh theme={null}
fly consul attach
```

Update your `fly.toml` file to mount your volume:

```yml theme={null}
[mounts]
  source = "litefs"
  destination = "/var/lib/litefs"
```

Deploy your app:

```sh theme={null}
fly deploy
```

TADA! You (hopefully) now have an app running with LiteFS! If you're having trouble, you can
ask for help in [the Fly community](https://community.fly.io).

### 4. Add some replicas in other regions

LiteFS isn't *super* useful if you're running only one node. So, add some
more nodes in more regions!

```sh theme={null}
# Add a clone in London
fly m clone --select --region lhr
# Add a clone in Sydney
fly m clone --select --region syd
```

## Next steps

[Back up your LiteFS cluster](/litefs/backup).