lfs-dal
A custom transfer agent for Git LFS powered by OpenDAL.
Overview
- Git LFS can switch the storage backend by custom transfer agents.
- OpenDAL provides access to many storage systems such as Azure, GCP, AWS S3, WebDAV, Dropbox, Google Drive, One Drive, etc.
- lfs-dal enables you to store LFS data on many storage systems!
Installation
Download the released binary or build from source.
# build from source
Usage
git-lfs
configuration
Configure git-lfs
to use lfs-dal
as a custom transfer agent.
lfs-dal
configuration
Configure OpenDAL service settings in lfs-dal
section at .lfsdalconfig
or .git/config
.
lfs-dal --list
shows available schemes.
For service-specific options, refer to the OpenDAL documentation.
[!NOTE] gitconfig does not allow
_
in keys. Use-
instead.
[!NOTE] lfs-dal looks for
.lfsdalconfig
and.git/config
..git/config
is not committed to the repository.
[!CAUTION] Do not commit your credentials to the repository. Some OpenDAL services support importing credentials via environment variables.
AWS S3 example
Debugging
For testing OpenDAL settings, run lfs-dal --exit
. It exits immediately after initializing OpenDAL.
For more detailed log, configure lfs-dal
to output log to a file.