Pure-FTPd is a free (BSD), secure, production-quality and standard-conformant FTP server.
This guide provides instructions for using the virtual user system to manage and control users. By using virtual users, FTP accounts can be administrated without affecting system accounts.
Let's initiate Pure-FTPd's installation by entering the following commands:
A menu containing Pure-FTPd options will pop-up. In my case, I've opted to leave these options at their defaults.
Having finished the installation process we now move into the configuration stage. We'll start by copying the sample configuration file and set the configuration options:
The chmod command was run to be able to edit the file (default permissions are set to -r--r--r--).
The CreateHomeDir option makes adding virtual users more easy by creating a user's home directory upon login (if it doesn't already exist).
We can either import users with system-level accounts (defined in /etc/master.passwd) at once or create new users manually. To import users that already exist on your system into the virtual user database, enter these commands:
It should be noted that pure-pwconvert only imports accounts that have shell access. Accounts with the shell set to nologin have to be added manually.
To add users to the Pure-FTPd virtual user database manually, we need to create a system-level account that will be associated with virtual users. Create a new user named vftp like this:
Having done this we can now add users to the virtual users database using the commands below:
Replace user with the desired username. With -d flag, the user will be chrooted. If you want to give user access to the whole filesystem, use -D instead of -d.
If you want to add additional users, just repeat the commands above with a different user.
To remove a user:
Now to start Pure-FTPd:
Initiate a FTP connection to test the server:
Now log in with a user account created as explained above. Commands such as ls, cp, pwd and less work just like in tcsh and bash shells. To quit the FTP session type exit.
To configure Pure-FTPd to start at boot time:
To restart Pure-FTPd and determine if it is running:
Pure-FTPd provides useful features for personal users as well as hosting providers. I've only touched the tip of the iceberg so do take a look at the project's website for the excellent documentation that is available.
This guide provides instructions for using the virtual user system to manage and control users. By using virtual users, FTP accounts can be administrated without affecting system accounts.
Let's initiate Pure-FTPd's installation by entering the following commands:
Code:
% su
# portsnap fetch update
# cd /usr/ports/ftp/pure-ftpd
# make configA menu containing Pure-FTPd options will pop-up. In my case, I've opted to leave these options at their defaults.
Code:
# make install clean
# rehashHaving finished the installation process we now move into the configuration stage. We'll start by copying the sample configuration file and set the configuration options:
Code:
# cd /usr/local/etc
# cp pure-ftpd.conf.sample pure-ftpd.conf
# chmod 644 pure-ftpd.confThe chmod command was run to be able to edit the file (default permissions are set to -r--r--r--).
Code:
# vi pure-ftpd.conf
VerboseLog yes
PureDB /usr/local/etc/pureftpd.pdb
CreateHomeDir yesThe CreateHomeDir option makes adding virtual users more easy by creating a user's home directory upon login (if it doesn't already exist).
We can either import users with system-level accounts (defined in /etc/master.passwd) at once or create new users manually. To import users that already exist on your system into the virtual user database, enter these commands:
Code:
# pure-pwconvert >> /usr/local/etc/pureftpd.passwd
# chmod 600 /usr/local/etc/pureftpd.passwd
# pure-pw mkdbIt should be noted that pure-pwconvert only imports accounts that have shell access. Accounts with the shell set to nologin have to be added manually.
To add users to the Pure-FTPd virtual user database manually, we need to create a system-level account that will be associated with virtual users. Create a new user named vftp like this:
Code:
# pw useradd vftp -s /sbin/nologin -w no -d /usr/home/vftp\
? -c "Virtual FTP user" -mHaving done this we can now add users to the virtual users database using the commands below:
Code:
# pure-pw useradd user -u vftp -g vftp -d /usr/home/vftp/user
# pure-pw mkdbReplace user with the desired username. With -d flag, the user will be chrooted. If you want to give user access to the whole filesystem, use -D instead of -d.
If you want to add additional users, just repeat the commands above with a different user.
To remove a user:
Code:
# pure-pw userdel userNow to start Pure-FTPd:
Code:
# /usr/local/etc/rc.d/pure-ftpd onestartInitiate a FTP connection to test the server:
Code:
% ftp localhost
Trying 127.0.0.1...
Connected to localhost.
220---------- Welcome to Pure-FTPd [TLS] ----------
220-You are user number 2 of 50 allowed.
220-Local time is now 13:39. Server port: 21.
220-IPv6 connections are also welcome on this server.
220 You will be disconnected after 15 minutes of inactivity.
Name (localhost:username):Now log in with a user account created as explained above. Commands such as ls, cp, pwd and less work just like in tcsh and bash shells. To quit the FTP session type exit.
To configure Pure-FTPd to start at boot time:
Code:
# echo 'pureftpd_enable="YES"' >> /etc/rc.confTo restart Pure-FTPd and determine if it is running:
Code:
# /usr/local/etc/rc.d/pure-ftpd restart
# /usr/local/etc/rc.d/pure-ftpd statusPure-FTPd provides useful features for personal users as well as hosting providers. I've only touched the tip of the iceberg so do take a look at the project's website for the excellent documentation that is available.
