LFS Test Server

LFS Test Server is an example server that implements the Git LFS API. Itis intended to be used for testing the Git LFS client and is not in aproduction ready state.

LFS Test Server is written in Go, with pre-compiled binaries available for Mac,Windows, Linux, and FreeBSD.

See CONTRIBUTING.md for info on working on LFS Test Server andsending patches.

Installing

Download the latest version. It is a single binary file.

Alternatively, use the Go installer:

  $ go install github.com/github/lfs-test-server

Building

To build from source, use the Go tools:

  $ go get github.com/github/lfs-test-server

Running

Running the binary will start an LFS server on localhost:8080 by default.There are few things that can be configured via environment variables:

LFS_LISTEN      # The address:port the server listens on, default: "tcp://:8080"LFS_HOST        # The host used when the server generates URLs, default: "localhost:8080"LFS_METADB      # The database file the server uses to store meta information, default: "lfs.db"LFS_CONTENTPATH # The path where LFS files are store, default: "lfs-content"LFS_ADMINUSER   # An administrator username, default: not setLFS_ADMINPASS   # An administrator password, default: not setLFS_CERT        # Certificate file for tlsLFS_KEY         # tls keyLFS_SCHEME      # set to 'https' to override default httpLFS_USETUS      # set to 'true' to enable tusd (tus.io) resumable upload server; tusd must be on PATH, installed separatelyLFS_TUSHOST     # The host used to start the tusd upload server, default "localhost:1080"

If the LFS_ADMINUSER and LFS_ADMINPASS variables are set, arudimentary admin interface can be accessed viahttp://$LFS_HOST/mgmt. Here you can add and remove users, which mustbe done before you can use the server with the client. If either ofthese variables are not set (which is the default), the administrativeinterface is disabled.

To use the LFS test server with the Git LFS client, configure it in the repository's .gitconfig file:

  [lfs]    url = "http://localhost:8080/"

HTTPS:

NOTE: If using https with a self signed cert also disable cert checking in the client repo.

  [lfs]    url = "https://localhost:8080/"  [http]    sslverify = false

An example usage:

Generate a key pair

openssl req -x509 -sha256 -nodes -days 2100 -newkey rsa:2048 -keyout mine.key -out mine.crt

Make yourself a run script

#!/bin/bashset -euset -o pipefailLFS_LISTEN="tcp://:9999"LFS_HOST="127.0.0.1:9999"LFS_CONTENTPATH="content"LFS_ADMINUSER="<cool admin user name>"LFS_ADMINPASS="<better admin password>"LFS_CERT="mine.crt"LFS_KEY="mine.key"LFS_SCHEME="https"export LFS_LISTEN LFS_HOST LFS_CONTENTPATH LFS_ADMINUSER LFS_ADMINPASS LFS_CERT LFS_KEY LFS_SCHEME./lfs-test-server

Build the server