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 sim-
     ply 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 explic-
     itly defines the path, name and extension of the config file. If must be an
     absolute path or a path relative to the configuration directory. The speci-
     fied  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 shutdown
     without abrupt  cancellation  of  the  currently  ongoing	client-initiated
     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_LOAD-
     DATA_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.7.4			    Jul 2026			 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+15.1.quarterly>

home | help