Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SFTPGO-SERVE(1)			 SFTPGo	Manual		       SFTPGO-SERVE(1)

NAME
       sftpgo-serve - Start the	SFTPGo service

SYNOPSIS
       sftpgo serve [flags]

DESCRIPTION
       To  start the SFTPGo with the default values for	the command line flags
       simply use:

       $ sftpgo	serve

       Please take a look at the usage below to	customize the startup options

OPTIONS
       -c, --config-dir="."	  Location of the config dir.  This  directory
       is  used	 as  the base for files	with a relative	path, e.g. the private
       keys for	the SFTP server	or the database	file if	you use	 a  file-based
       data  provider.	 The  configuration  file,  if	not explicitly set, is
       looked for in this dir. We support reading from JSON, TOML, YAML,  HCL,
       envfile	and Java properties config files. The default config file name
       is "sftpgo" and therefore "sftpgo.json",	"sftpgo.yaml" and  so  on  are
       searched.  This flag can	be set using SFTPGO_CONFIG_DIR env var too.

       --config-file=""	     Path to SFTPGo configuration file.	 This flag ex-
       plicitly	 defines  the  path, name and extension	of the config file. If
       must be an absolute path	or a path relative to the configuration	direc-
       tory. The specified file	name must have a  supported  extension	(JSON,
       YAML,  TOML,  HCL  or  Java  properties).   This	 flag can be set using
       SFTPGO_CONFIG_FILE env var too.

       --grace-time=0	   Graceful shutdown is	an option to initiate a	 shut-
       down without abrupt cancellation	of the currently ongoing client-initi-
       ated  transfer sessions.	 This grace time defines the number of seconds
       allowed for existing transfers to get completed before  shutting	 down.
       A graceful shutdown is triggered	by an interrupt	signal.	 This flag can
       be  set using SFTPGO_GRACE_TIME env var too. 0 means disabled. (default
       0)

       -h, --help[=false]      help for	serve

       --loaddata-clean[=false]	      Determine	 if  the  loaddata-from	  file
       should  be  removed after a successful load. This flag can be set using
       SFTPGO_LOADDATA_CLEAN env var too. (default "false")

       --loaddata-from=""      Load users and folders  from  this  file.   The
       file  must  be  specified as absolute path and it must contain a	backup
       obtained	using the "dumpdata" REST API  or  compatible  content.	  This
       flag can	be set using SFTPGO_LOADDATA_FROM env var too.

       --loaddata-mode=1      Restore mode for data to load:
	 0 - new users are added, existing users are
	     updated
	 1  - New users	are added, existing users are	     not modified This
       flag can	be set using SFTPGO_LOADDATA_MODE env var too.

       --loaddata-scan=0      Quota scan mode after data load:
	 0 - no	quota scan
	 1 - scan quota
	 2 - scan quota	if the user has	quota restrictions This	 flag  can  be
       set using SFTPGO_LOADDATA_QUOTA_SCAN env	var too.  (default 0)

       -z,  --log-compress[=false]	 Determine  if	the  rotated log files
       should  be  compressed  using  gzip.  This  flag	 can  be   set	 using
       SFTPGO_LOG_COMPRESS  env	 var  too.   It	 is unused if log-file-path is
       empty.

       -l, --log-file-path="sftpgo.log"	     Location for the log file.	 Leave
       empty  to write logs to the standard output. This flag can be set using
       SFTPGO_LOG_FILE_PATH env	var too.

       --log-level="debug"	Set the	log level. Supported values:

       debug, info, warn, error.

       This flag can be	set using SFTPGO_LOG_LEVEL env var too.

       -a, --log-max-age=28	 Maximum number	of  days  to  retain  old  log
       files.	This  flag can be set using SFTPGO_LOG_MAX_AGE env var too. It
       is unused if log-file-path is empty.

       -b, --log-max-backups=5	    Maximum number of old log files to retain.
       This flag can be	set using SFTPGO_LOG_MAX_BACKUPS env var  too.	It  is
       unused if log-file-path is empty.

       -s,  --log-max-size=10	    Maximum  size in megabytes of the log file
       before it gets rotated. This flag can be	set using  SFTPGO_LOG_MAX_SIZE
       env var too. It is unused if log-file-path is empty.

       --log-utc-time[=false]	    Use	UTC time for logging. This flag	can be
       set using SFTPGO_LOG_UTC_TIME env var too.

SEE ALSO
       sftpgo(1)

SFTPGo 2.6.6			   Apr 2025		       SFTPGO-SERVE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=sftpgo-serve&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help