LiteFS - Distributed SQLite
Important: We are not able to provide support or guidance for this product. Use with caution. Do not combine LiteFS with autostop/autostart on Fly Machines. The Fly Proxy’s autoscaler can shut down or restart Machines without any awareness of LiteFS lease ownership or data freshness, which can result in a stale machine winning the lease and LiteFS discarding newer changes and LTX file data—risking rollback and data loss.
LiteFS is a distributed file system that transparently replicates SQLite databases. You can run your application like it’s running against a local on-disk SQLite database but behind the scenes the database is replicated to all the nodes in your cluster. With LiteFS, you can run your database right next to your application on the edge. You can run LiteFS anywhere!
Project status
LiteFS is stable and running in production environments. The project is still pre-1.0 so APIs may change and features could be removed. Please remember that all software has bugs so we recommend you set up regular off-site backups in case of malfunction or disk corruption.
Exploring our guides
You can get up and running quickly with one of our guides:
Speedrun: Adding LiteFS to your app the fastest way to get started with LiteFS on Fly.io.
Getting Started on Fly.io helps you add LiteFS to an existing application and deploy to Fly.io. This guide provides more details and explanation than the Speedrun.
Getting Started with Docker helps you add LiteFS to an existing application that you want to run outside of Fly.io.
How LiteFS Works explains the concepts behind LiteFS.