summaryrefslogtreecommitdiff
path: root/doc/workflow
diff options
context:
space:
mode:
authorLin Jen-Shin <godfat@godfat.org>2018-04-25 19:09:55 +0800
committerLin Jen-Shin <godfat@godfat.org>2018-04-25 19:09:55 +0800
commit6c21b502d3ddad652312d387cdb461c2ede253e0 (patch)
tree5272a81e4e77d7e847c4b4eba149ce6c684404c0 /doc/workflow
parent185d278bbf298e4d4ff98e418c3a7577e401359a (diff)
parenta5ffb012971a3eb106b2613c932503d1f61426be (diff)
downloadgitlab-ce-6c21b502d3ddad652312d387cdb461c2ede253e0.tar.gz
Merge remote-tracking branch 'upstream/master' into qa-add-more-key-tests
* upstream/master: (36 commits) Change language to be more inclusive of those with accessibility requirements Show group id in group settings Cleanup after adding MR diff's commit_count (try 2) Mock Pager in Karma tests Backport dev env check for storage settings deprecation Do not preload settings Update import on actions file to fix conflict when rewire plugin was added Broken link fix Make /copy_metadata only handle the first issuable passed Allow admins to push to empty repos Only show push-to-master authorized users Add documentation about resetting the runner registration token Document externally hosted LFS objects Align project avatar on small viewports fix CI BABEL_ENV variable document the spyOnDependency method disable sourcemaps when generating coverage report to avoid out-of-memory errors only apply rewire plugin when running karma tests fix illegal references to "this" in module context add default exports to prevent rewire plugin from breaking vuex ...
Diffstat (limited to 'doc/workflow')
-rw-r--r--doc/workflow/lfs/manage_large_binaries_with_git_lfs.md17
1 files changed, 17 insertions, 0 deletions
diff --git a/doc/workflow/lfs/manage_large_binaries_with_git_lfs.md b/doc/workflow/lfs/manage_large_binaries_with_git_lfs.md
index 377eee69c11..104ac0cf31b 100644
--- a/doc/workflow/lfs/manage_large_binaries_with_git_lfs.md
+++ b/doc/workflow/lfs/manage_large_binaries_with_git_lfs.md
@@ -244,3 +244,20 @@ GitLab checks files to detect LFS pointers on push. If LFS pointers are detected
Verify that LFS in installed locally and consider a manual push with `git lfs push --all`.
If you are storing LFS files outside of GitLab you can disable LFS on the project by settting `lfs_enabled: false` with the [projects api](../../api/projects.md#edit-project).
+
+### Hosting LFS objects externally
+
+It is possible to host LFS objects externally by setting a custom LFS url with `git config -f .lfsconfig lfs.url https://example.com/<project>.git/info/lfs`.
+
+Because GitLab verifies the existence of objects referenced by LFS pointers, push will fail when LFS is enabled for the project.
+
+LFS can be disabled for a project by Owners and Masters using the [Project API](../../api/projects.md#edit-project).
+
+```bash
+curl --request PUT \
+ --url https://example.com/api/v4/projects/<PROJECT_ID> \
+ --header 'Private-Token: <YOUR_PRIVATE_TOKEN>' \
+ --data 'lfs_enabled=false'
+```
+
+Note, `<PROJECT_ID>` can also be substituted with a [namespaced path](../../api/README.md#namespaced-path-encoding).