beenull/sftpgo
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
sftpgo/docs/build-from-source.md
Nicola Murino fc648454df
CI: use Docker to build x86_64 Linux packages 
therefore Linux packages are compiled with Docker for all supported
architectures

Signed-off-by: Nicola Murino <nicola.murino@gmail.com>
2022-09-08 13:41:00 +02:00

1.9 KiB
Raw Permalink Blame History

Build SFTPGo from source

Download the sources and use go build.

The following build tags are available:

  • nogcs, disable Google Cloud Storage backend, default enabled
  • nos3, disable S3 Compabible Object Storage backends, default enabled
  • noazblob, disable Azure Blob Storage backend, default enabled
  • nobolt, disable Bolt data provider, default enabled
  • nomysql, disable MySQL data provider, default enabled
  • nopgsql, disable PostgreSQL data provider, default enabled
  • nosqlite, disable SQLite data provider, default enabled
  • noportable, disable portable mode, default enabled
  • nometrics, disable Prometheus metrics, default enabled

If no build tag is specified the build will include the default features.

The optional SQLite driver is a CGO package and so it requires a C compiler at build time. On Linux and macOS, a compiler is easy to install or already installed. On Windows, you need to download MinGW-w64 and build SFTPGo from its command prompt.

The compiler is a build time only dependency. It is not required at runtime.

Version info, such as git commit and build date, can be embedded setting the following string variables at build time:

  • github.com/drakkan/sftpgo/v2/version.commit
  • github.com/drakkan/sftpgo/v2/version.date

For example, you can build using the following command:

go build -tags nogcs,nos3,nosqlite -ldflags "-s -w -X github.com/drakkan/sftpgo/v2/version.commit=`git describe --always --abbrev=8 --dirty` -X github.com/drakkan/sftpgo/v2/version.date=`date -u +%FT%TZ`" -o sftpgo

You should get a version that includes git commit, build date and available features like this one:

$ ./sftpgo -v
SFTPGo 0.9.6-dev-b30614e-dirty-2020-06-19T11:04:56Z +metrics -gcs -s3 +bolt +mysql +pgsql -sqlite +portable