1SSHFS(1)                         User Commands                        SSHFS(1)
2
3
4

NAME

6       SSHFS - filesystem client based on SSH
7

SYNOPSIS

9       To mount a filesystem:
10
11          sshfs [user@]host:[dir] mountpoint [options]
12
13       If  host  is  a numeric IPv6 address, it needs to be enclosed in square
14       brackets.
15
16       To unmount it:
17
18          fusermount3 -u mountpoint   # Linux
19          umount mountpoint           # OS X, FreeBSD
20

DESCRIPTION

22       SSHFS allows you to mount a remote  filesystem  using  SSH  (more  pre‐
23       cisely,  the  SFTP subsystem). Most SSH servers support and enable this
24       SFTP access by default, so SSHFS is very simple to use - there's  noth‐
25       ing to do on the server-side.
26
27       By  default,  file  permissions are ignored by SSHFS. Any user that can
28       access the filesystem will be able to perform any  operation  that  the
29       remote server permits - based on the credentials that were used to con‐
30       nect to the server. If this is undesired, local permission checking can
31       be enabled with -o default_permissions.
32
33       By  default, only the mounting user will be able to access the filesys‐
34       tem. Access for other users can be enabled by passing  -o  allow_other.
35       In this case you most likely also want to use -o default_permissions.
36
37       It is recommended to run SSHFS as regular user (not as root).  For this
38       to work the mountpoint must be owned by the user.  If username is omit‐
39       ted  SSHFS  will  use  the local username. If the directory is omitted,
40       SSHFS will mount the (remote) home directory.  If you need to  enter  a
41       password sshfs will ask for it (actually it just runs ssh which ask for
42       the password if needed).
43

OPTIONS

45       -o opt,[opt...]
46              mount options, see below for details. A a variety of SSH options
47              can  be given here as well, see the manual pages for sftp(1) and
48              ssh_config(5).
49
50       -h, --help
51              print help and exit.
52
53       -V, --version
54              print version information and exit.
55
56       -d, --debug
57              print debugging information.
58
59       -p PORT
60              equivalent to '-o port=PORT'
61
62       -f     do not daemonize, stay in foreground.
63
64       -s     Single threaded operation.
65
66       -C     equivalent to '-o compression=yes'
67
68       -F ssh_configfile
69              specifies alternative ssh configuration file
70
71       -1     equivalent to '-o ssh_protocol=1'
72
73       -o reconnect
74              automatically reconnect to server if connection is  interrupted.
75              Attempts  to  access files that were opened before the reconnec‐
76              tion will give errors and need to be re-opened.
77
78       -o delay_connect
79              Don't immediately connect to server, wait  until