You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
LFS Test Server is an example server that implements the Git LFS API. It
is intended to be used for testing the Git LFS client and is not in a
production 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 and
sending patches.
Installing
Use the Go installer:
$ go install github.com/git-lfs/lfs-test-server@latest
Building
To build from source, use the Go tools:
$ go get github.com/git-lfs/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 set
LFS_ADMINPASS # An administrator password, default: not set
LFS_CERT # Certificate file for tls
LFS_KEY # tls key
LFS_SCHEME # set to 'https' to override default http
LFS_USETUS # set to 'true' to enable tusd (tus.io) resumable upload server; tusd must be on PATH, installed separately
LFS_TUSHOST # The host used to start the tusd upload server, default "localhost:1080"
If the LFS_ADMINUSER and LFS_ADMINPASS variables are set, a
rudimentary admin interface can be accessed via
https://$LFS_HOST/mgmt. Here you can add and remove users, which must
be done before you can use the server with the client. If either of
these variables are not set (which is the default), the administrative
interface is disabled.
To use the LFS test server with the Git LFS client, configure it in the repository's .lfsconfig:
[lfs]
url = "https://localhost:8080/"
HTTPS:
NOTE: If using https with a self signed cert also disable cert checking in the client repo.
lfs-test-server supports a basic cmd to lookup OID's via the cmdline to help in debugging, eg. investigating client problems with a particular OID and it's properties.
In this mode lfs-test-server expects the same configuration as when running in daemon mode, but will just executing the requested cmd and then exit.
This is especially helpful in server environments where it's not always possible to get to the web interface easily or where it's just too slow because of DB size.
lfs-test-server cmd <OID>
Outputs the full OID record
Example
% . /etc/default/lfs-instancefoo # to source server config
% ./lfs-test-server cmd 7c9414fe21ad7b45ffb6e72da86f9a9e13dbb2971365ae7bcb8cc7fbbba7419c
&{Oid:7c9414fe21ad7b45ffb6e72da86f9a9e13dbb2971365ae7bcb8cc7fbbba7419c Size:3334144 Existing:false}