{"id":13514020,"url":"https://github.com/superfly/litefs","last_synced_at":"2025-05-12T20:49:55.560Z","repository":{"id":49791592,"uuid":"484136945","full_name":"superfly/litefs","owner":"superfly","description":"FUSE-based file system for replicating SQLite databases across a cluster of machines","archived":false,"fork":false,"pushed_at":"2025-04-22T19:14:21.000Z","size":1074,"stargazers_count":4350,"open_issues_count":57,"forks_count":103,"subscribers_count":42,"default_branch":"main","last_synced_at":"2025-05-07T23:57:41.020Z","etag":null,"topics":["sqlite"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/superfly.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-04-21T17:03:28.000Z","updated_at":"2025-05-07T01:25:35.000Z","dependencies_parsed_at":"2025-04-23T17:40:03.409Z","dependency_job_id":"23d251ce-0608-4bec-ab7a-5b602623da3a","html_url":"https://github.com/superfly/litefs","commit_stats":null,"previous_names":[],"tags_count":38,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superfly%2Flitefs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superfly%2Flitefs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superfly%2Flitefs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superfly%2Flitefs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/superfly","download_url":"https://codeload.github.com/superfly/litefs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253820548,"owners_count":21969541,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["sqlite"],"created_at":"2024-08-01T05:00:43.380Z","updated_at":"2025-05-12T20:49:55.519Z","avatar_url":"https://github.com/superfly.png","language":"Go","readme":"LiteFS\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/superfly/litefs)\n![Status](https://img.shields.io/badge/status-beta-blue)\n![GitHub](https://img.shields.io/github/license/superfly/litefs)\n======\n\nLiteFS is a FUSE-based file system for replicating SQLite databases across a\ncluster of machines. It works as a passthrough file system that intercepts\nwrites to SQLite databases in order to detect transaction boundaries and record\nchanges on a per-transaction level in [LTX files](https://github.com/superfly/ltx).\n\nThis project is actively maintained but is currently in a beta state. Please\nreport any bugs as an issue on the GitHub repository.\n\nYou can find a [Getting Started guide](https://fly.io/docs/litefs/getting-started/)\non [LiteFS' documentation site](https://fly.io/docs/litefs/). Please see the\n[ARCHITECTURE.md](/docs/ARCHITECTURE.md) design document for details about how\nLiteFS works.\n\n\n## SQLite TCL Test Suite\n\nIt's a goal of LiteFS to pass the SQLite TCL test suite, however, this is\ncurrently a work in progress. LiteFS doesn't have database deletion implemented\nyet so that causes many tests to fail during teardown.\n\nTo run a test from the suite against LiteFS, you can use the `Dockerfile.test`\nto run it in isolation. First build the Dockerfile:\n\n```sh\ndocker build -t litefs-test -f Dockerfile.test .\n```\n\nThen run it with the filename of the test you want to run. In this case, we\nare running `select1.test`:\n\n```sh\ndocker run --device /dev/fuse --cap-add SYS_ADMIN -it litefs-test select1.test\n```\n\n\n## Contributing\n\nLiteFS contributions work a little different than most GitHub projects. If you\nhave a small bug fix or typo fix, please PR directly to this repository.\n\nIf you would like to contribute a feature, please follow these steps:\n\n1. Discuss the feature in an issue on this GitHub repository.\n2. Create a pull request to **your fork** of the repository.\n3. Post a link to your pull request in the issue for consideration.\n\nThis project has a roadmap and features are added and tested in a certain order.\nAdditionally, it's likely that code style, implementation details, and test\ncoverage will need to be tweaked so it's easier to for me to grab your\nimplementation as a starting point when implementing a feature.\n","funding_links":[],"categories":["Go","others","Backup, Sync \u0026 Replication","sqlite","backup and replicate","\u003ca name=\"Go\"\u003e\u003c/a\u003eGo"],"sub_categories":["Rust"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuperfly%2Flitefs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsuperfly%2Flitefs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuperfly%2Flitefs/lists"}