GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
SFTPGO-SERVE(1) SFTPGo Manual SFTPGO-SERVE(1)

sftpgo-serve - Start the SFTPGo service

sftpgo serve [flags]

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

-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 explicitly 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 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 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_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.

sftpgo(1)

Jul 2025 SFTPGo 2.6.6

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.