2020-03-04 22:10:58 +00:00
# Portable mode
SFTPGo allows to share a single directory on demand using the `portable` subcommand:
2020-06-15 21:46:11 +00:00
```console
2020-03-04 22:10:58 +00:00
sftpgo portable --help
2020-07-09 16:58:22 +00:00
To serve the current working directory with auto generated credentials simply
use:
2020-03-04 22:10:58 +00:00
2020-07-09 16:58:22 +00:00
$ sftpgo portable
2020-03-04 22:10:58 +00:00
Please take a look at the usage below to customize the serving parameters
Usage:
sftpgo portable [flags]
Flags:
2020-07-29 19:56:56 +00:00
-C, --advertise-credentials If the SFTP/FTP service is
advertised via multicast DNS, this
flag allows to put username/password
inside the advertised TXT record
-S, --advertise-service Advertise SFTP/FTP service using
multicast DNS
2020-07-09 16:58:22 +00:00
--allowed-extensions stringArray Allowed file extensions case
insensitive. The format is
/dir::ext1,ext2.
For example: "/somedir::.jpg,.png"
--denied-extensions stringArray Denied file extensions case
insensitive. The format is
/dir::ext1,ext2.
For example: "/somedir::.jpg,.png"
-d, --directory string Path to the directory to serve.
This can be an absolute path or a path
relative to the current directory
(default ".")
-f, --fs-provider int 0 means local filesystem,
1 Amazon S3 compatible,
2 Google Cloud Storage
2020-07-29 19:56:56 +00:00
--ftpd-cert string Path to the certificate file for FTPS
--ftpd-key string Path to the key file for FTPS
--ftpd-port int 0 means a random unprivileged port,
< 0 disabled ( default -1 )
2020-07-09 16:58:22 +00:00
--gcs-automatic-credentials int 0 means explicit credentials using
a JSON credentials file, 1 automatic
(default 1)
2020-03-04 22:10:58 +00:00
--gcs-bucket string
2020-07-09 16:58:22 +00:00
--gcs-credentials-file string Google Cloud Storage JSON credentials
file
--gcs-key-prefix string Allows to restrict access to the
virtual folder identified by this
prefix and its contents
2020-03-04 22:10:58 +00:00
--gcs-storage-class string
2020-03-05 14:37:10 +00:00
-h, --help help for portable
-l, --log-file-path string Leave empty to disable logging
2020-04-28 13:02:48 +00:00
-v, --log-verbose Enable verbose logs
2020-07-09 16:58:22 +00:00
-p, --password string Leave empty to use an auto generated
value
-g, --permissions strings User's permissions. "*" means any
permission (default [list,download])
2020-03-04 22:10:58 +00:00
-k, --public-key strings
--s3-access-key string
--s3-access-secret string
--s3-bucket string
--s3-endpoint string
2020-07-09 16:58:22 +00:00
--s3-key-prefix string Allows to restrict access to the
virtual folder identified by this
prefix and its contents
2020-03-04 22:10:58 +00:00
--s3-region string
--s3-storage-class string
2020-07-09 16:58:22 +00:00
--s3-upload-concurrency int How many parts are uploaded in
parallel (default 2)
--s3-upload-part-size int The buffer size for multipart uploads
(MB) (default 5)
2020-07-29 19:56:56 +00:00
-s, --sftpd-port int 0 means a random unprivileged port
2020-07-09 16:58:22 +00:00
-c, --ssh-commands strings SSH commands to enable.
"*" means any supported SSH command
including scp
(default [md5sum,sha1sum,cd,pwd,scp])
-u, --username string Leave empty to use an auto generated
value
2020-08-17 12:08:08 +00:00
--webdav-cert string Path to the certificate file for WebDAV
over HTTPS
--webdav-key string Path to the key file for WebDAV over
HTTPS
--webdav-port int 0 means a random unprivileged port,
< 0 disabled ( default -1 )
2020-03-04 22:10:58 +00:00
```
2020-07-29 19:56:56 +00:00
In portable mode, SFTPGo can advertise the SFTP/FTP services and, optionally, the credentials via multicast DNS, so there is a standard way to discover the service and to automatically connect to it.
2020-03-04 22:10:58 +00:00
2020-07-29 19:56:56 +00:00
Here is an example of the advertised SFTP service including credentials as seen using `avahi-browse` :
2020-03-04 22:10:58 +00:00
2020-06-15 21:46:11 +00:00
```console
2020-03-04 22:10:58 +00:00
= enp0s31f6 IPv4 SFTPGo portable 53705 SFTP File Transfer local
hostname = [p1.local]
address = [192.168.1.230]
port = [53705]
txt = ["password=EWOo6pJe" "user=user" "version=0.9.3-dev-b409523-dirty-2019-10-26T13:43:32Z"]
```
