BigW Consortium Gitlab

lfs_administration.md 1.23 KB
Newer Older
1
# GitLab Git LFS Administration
2 3 4 5 6 7

Documentation on how to use Git LFS are under [Managing large binary files with Git LFS doc](manage_large_binaries_with_git_lfs.md).

## Requirements

* Git LFS is supported in GitLab starting with version 8.2.
8
* Users need to install [Git LFS client](https://git-lfs.github.com) version 1.0.1 and up.
9 10 11

## Configuration

12 13
Git LFS objects can be large in size. By default, they are stored on the server
GitLab is installed on.
14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40

There are two configuration options to help GitLab server administrators:

* Enabling/disabling Git LFS support
* Changing the location of LFS object storage

### Omnibus packages

In `/etc/gitlab/gitlab.rb`:

```ruby
gitlab_rails['lfs_enabled'] = false
gitlab_rails['lfs_storage_path'] = "/mnt/storage/lfs-objects"
```

### Installations from source

In `config/gitlab.yml`:

```yaml
  lfs:
    enabled: false
    storage_path: /mnt/storage/lfs-objects
```

## Known limitations

41 42
* Currently, storing GitLab Git LFS objects on a non-local storage (like S3 buckets)
  is not supported
43
* Currently, removing LFS objects from GitLab Git LFS storage is not supported
44 45
* LFS authentications via SSH is not supported for the time being
* Only compatible with the GitLFS client versions 1.1.0 or 1.0.2.