| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> |
| <html xmlns="http://www.w3.org/1999/xhtml" |
| xmlns:wicket="http://wicket.apache.org/dtds.data/wicket-xhtml1.3-strict.dtd" |
| xml:lang="en" |
| lang="en"> |
| |
| <body> |
| <wicket:extend> |
| <div class="container"> |
| <div class="markdown"> |
| <div class="row"> |
| <div class="span10 offset1"> |
| |
| <div class="alert alert-danger"> |
| <h3><center>Using the Filestore</center></h3> |
| <p> |
| <strong>All clients intending to use the filestore must first install the <a href="https://git-lfs.github.com/">Git-LFS Client</a> and then run <code>git lfs init</code> to register the hooks globally.</strong><br/> |
| <i>This version of GitBlit has been verified with Git-LFS client version 0.6.0 which requires Git v1.8.2 or higher.</i> |
| </p> |
| </div> |
| |
| <h3>Clone</h3> |
| <p> |
| Just <code>git clone</code> as usual, no further action is required as GitBlit is configured to use the default Git-LFS end point <code>{repository}/info/lfs/objects/</code>.<br/> |
| <i>If the repository uses a 3rd party Git-LFS server you will need to <a href="https://github.com/github/git-lfs/blob/master/docs/spec.md#the-server">manually configure the correct endpoints</a></i>. |
| </p> |
| |
| <h3>Add</h3> |
| <p>After configuring the file types or paths to be tracked using <code>git lfs track "*.bin"</code> just add files as usual with <code>git add</code> command.<br/> |
| <i>Tracked files can also be configured manually using the <code>.gitattributes</code> file</i>.</p> |
| |
| <h3>Remove</h3> |
| <p>When you remove a Git-LFS tracked file only the pointer file will be removed from your repository.<br/> |
| <i>All files remain on the server to allow previous versions to be checked out.</i> |
| </p> |
| |
| <h3>Learn more...</h3> |
| <p><a href="https://github.com/github/git-lfs/blob/master/docs/spec.md">See the current Git-LFS specification for further details</a>.</p> |
| <br /> |
| |
| <div class="alert alert-warn"> |
| <h3><center>Limitations & Warnings</center></h3> |
| <p>GitBlit currently provides a server-only implementation of the opensource Git-LFS API, <a href="https://github.com/github/git-lfs/wiki/Implementations">other implementations</a> are available.<br/> |
| However, until <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=470333">JGit provides Git-LFS client capabilities</a> some GitBlit features may not be fully supported when using the filestore. |
| Notably: |
| <ul> |
| <li>Mirroring a repository that uses Git-LFS - Only the pointer files, not the large files, are mirrored.</li> |
| <li>Federation - Only the pointer files, not the large files, are transfered.</li> |
| </ul> |
| </p> |
| </div> |
| |
| <div class="alert alert-info"> |
| <h3><center>GitBlit Configuration</center></h3> |
| <p>GitBlit provides the following configuration items when using the filestore: |
| <h4>filestore.storageFolder</h4> |
| <p>Defines the path on the server where filestore objects are to be saved. This defaults to <code>${baseFolder}/lfs</code></p> |
| <h4>filestore.maxUploadSize</h4> |
| <p>Defines the maximum allowable size that can be uploaded to the filestore. Once a file is uploaded it will be unaffected by later changes in this property. This defaults to <code>-1</code> indicating no limits.</p> |
| </p> |
| </div> |
| |
| </div> |
| </div> |
| </div> |
| </div> |
| </wicket:extend> |
| </body> |
| </html> |