Configuring FTP Access

From Sympl Wiki
Jump to navigation Jump to search

FTP can be set up in a number of ways, for the basic guide, we will look at setting up access per domain, and for specific users on that domain.

Per domain access

You can set up ftp access to a domain by adding a file called 'ftp-password' containing the password to the relevent domain's config folder:

/srv/example.com/config/ftp-password

The directory path will automatically be set to the public folder of the domain /srv/example.com/public/ allowing access to the logs and htdocs directories.

Per user domain access

For granting access to individual users to a domain you will need to set up another file called ftp-users. The file needs to be in the same location of /srv/example.com/config/ftp-users

The file needs to be in the following format and comments start with a #:

 # username:password:directory:quota
 babs:babsPassword:babs:10M

This file will allow access to babs@example.com with the password babsPassword to the folder /srv/example.com/public/babs/ with a quota of 10M. The directory must be relative to the public folder of the domain the ftp-users file correlates to, otherwise you will get an authentication error.

For more details on configuring FTP Access, see FTP_Configuration_Reference

SFTP (FTP over SSH)

Any regular system user, such as the sympl user or other, users set up with adduser command, will be able to connect using SFTP by default.

This is an FTP session connecting over an SSH connection and as such carries the encryption of the SSH connection, but allows full access to the server rather than limiting the user to the relevant domain, potentially allowing snooping on emails or changing of the operating system configuration, and as such it is suggested this isn't used for third parties.

You can connect using SFTP using most FTP clients - you will need the IP address or hostname of the server, username and password or SSH key. The sympl user that was set up when Sympl was installed will be able to connect over SFTP, and can be used to make most configuration changes.

See Also