added instructions on running an ftp server

README.md

@@ -373,4 +373,85 @@ Then test it with:
 ifup -v wlp0s0
 ```
 
+# Running an anonymous ftp server
+
+Install the vsftpd sever:
+
+```
+sudo apt install vsftpd
+```
+
+Use the `vsftpd.conf` from this git repo:
+
+```
+sudo cp ./vsftpd.conf /etc/
+```
+
+The directory shared via ftp will be `/srv/ftp`. You can change this by altering the `ftp` users' home directory in `/etc/passwd`.
+
+If you want to share an external drive then first partition it, then format it and give it a unique label. Let's assume it's called `/dev/sdb`.
+
+__WARNING THE FOLLOWING WILL DELETE EVERYTHIN ON THE DRIVE__
+
+To partition run `sudo fdisk /dev/sdb`, then hit `d` and enter again until there are no partitions left. Now hit `c` to create a partition and hit enter for each question to accept the defaults, then hit `w` to write the changes to disk.
+
+Now format the drive:
+
+```
+# WARNING THIS WILL DELETE EVERYTHINg ON THE DRIVE
+
+sudo mkfs.ext4 -L my-labeled-drive /dev/sdb1
+```
+
+To make the drive automatically mount in the ftp directory on boot add the following line to `/etc/fstab`:
+
+```
+LABEL=my-labeled-drive /srv/ftp        ext4    noatime,errors=remount-ro 0 2
+```
+
+Now mount it to ensure that the fstab line works:
+
+```
+sudo mount /srv/ftp
+```
+
+While the drive is mounted, set the permissions:
+
+```
+sudo chown root.ftp /srv/ftp
+sudo chmod 755 /srv/ftp
+```
+
+If you want users to be able to upload to an `uploads` directory then do:
+
+```
+sudo mkdir /srv/ftp/uploads
+sudo chown ftp.ftp /srv/ftp/uploads
+sudo chmod 755 /srv/ftp/uploads
+```
+
+by default no-one will be able to delete from the `uploads/` directory. To change this modify the line in `/etc/vsftpd.conf` saying `chown_uploads=YES` to `chown_uploads=NO`. Note that this will allow anyone to delete anything in the uploads directory.
+
+Now restart vsftpd to make it use the new configuration:
+
+```
+sudo /etc/init.d/vsftpd restart
+```
+
+Create a test file to download:
+
+```
+sudo echo "Welcome to my ftp server!" > /srv/ftp/README
+```
+
+Test that you can connect to the ftp server using e.g. `ncftp` from another computer and download and upload
+
+```
+sudo apt install ncftp
+echo "TEST UPLOAD CONTENT" > test
+ncftp <ip_address_of_pogogplug>
+get README
+cd uploads/
+put test
+```
 

vsftpd.conf

@@ -0,0 +1,159 @@
+# Example config file /etc/vsftpd.conf
+#
+# The default compiled in settings are fairly paranoid. This sample file
+# loosens things up a bit, to make the ftp daemon more usable.
+# Please see vsftpd.conf.5 for all compiled in defaults.
+#
+# READ THIS: This example file is NOT an exhaustive list of vsftpd options.
+# Please read the vsftpd.conf.5 manual page to get a full idea of vsftpd's
+# capabilities.
+#
+#
+# Run standalone?  vsftpd can run either from an inetd or as a standalone
+# daemon started from an initscript.
+listen=NO
+#
+# This directive enables listening on IPv6 sockets. By default, listening
+# on the IPv6 "any" address (::) will accept connections from both IPv6
+# and IPv4 clients. It is not necessary to listen on *both* IPv4 and IPv6
+# sockets. If you want that (perhaps because you want to listen on specific
+# addresses) then you must run two copies of vsftpd with two configuration
+# files.
+listen_ipv6=YES
+#
+# Allow anonymous FTP? (Disabled by default).
+anonymous_enable=YES
+#
+# Uncomment this to allow local users to log in.
+local_enable=YES
+#
+# Uncomment this to enable any form of FTP write command.
+write_enable=YES
+#
+# Default umask for local users is 077. You may wish to change this to 022,
+# if your users expect that (022 is used by most other ftpd's)
+local_umask=022
+
+anon_umask=022
+chown_upload_mode=0644
+
+#
+# Uncomment this to allow the anonymous FTP user to upload files. This only
+# has an effect if the above global write enable is activated. Also, you will
+# obviously need to create a directory writable by the FTP user.
+anon_upload_enable=YES
+#
+# Uncomment this if you want the anonymous FTP user to be able to create
+# new directories.
+anon_mkdir_write_enable=YES
+#
+# Activate directory messages - messages given to remote users when they
+# go into a certain directory.
+dirmessage_enable=YES
+#
+# If enabled, vsftpd will display directory listings with the time
+# in  your  local  time  zone.  The default is to display GMT. The
+# times returned by the MDTM FTP command are also affected by this
+# option.
+use_localtime=YES
+#
+# Activate logging of uploads/downloads.
+#xferlog_enable=YES
+#
+# Make sure PORT transfer connections originate from port 20 (ftp-data).
+connect_from_port_20=YES
+#
+# If you want, you can arrange for uploaded anonymous files to be owned by
+# a different user. Note! Using "root" for uploaded files is not
+# recommended!
+chown_uploads=YES
+chown_username=nobody
+#
+# You may override where the log file goes if you like. The default is shown
+# below.
+#xferlog_file=/var/log/vsftpd.log
+#
+# If you want, you can have your log file in standard ftpd xferlog format.
+# Note that the default log file location is /var/log/xferlog in this case.
+#xferlog_std_format=YES
+#
+# You may change the default value for timing out an idle session.
+#idle_session_timeout=600
+#
+# You may change the default value for timing out a data connection.
+#data_connection_timeout=120
+#
+# It is recommended that you define on your system a unique user which the
+# ftp server can use as a totally isolated and unprivileged user.
+#nopriv_user=ftpsecure
+#
+# Enable this and the server will recognise asynchronous ABOR requests. Not
+# recommended for security (the code is non-trivial). Not enabling it,
+# however, may confuse older FTP clients.
+#async_abor_enable=YES
+#
+# By default the server will pretend to allow ASCII mode but in fact ignore
+# the request. Turn on the below options to have the server actually do ASCII
+# mangling on files when in ASCII mode.
+# Beware that on some FTP servers, ASCII support allows a denial of service
+# attack (DoS) via the command "SIZE /big/file" in ASCII mode. vsftpd
+# predicted this attack and has always been safe, reporting the size of the
+# raw file.
+# ASCII mangling is a horrible feature of the protocol.
+#ascii_upload_enable=YES
+#ascii_download_enable=YES
+#
+# You may fully customise the login banner string:
+#ftpd_banner=Welcome to blah FTP service.
+#
+# You may specify a file of disallowed anonymous e-mail addresses. Apparently
+# useful for combatting certain DoS attacks.
+#deny_email_enable=YES
+# (default follows)
+#banned_email_file=/etc/vsftpd.banned_emails
+#
+# You may restrict local users to their home directories.  See the FAQ for
+# the possible risks in this before using chroot_local_user or
+# chroot_list_enable below.
+#chroot_local_user=YES
+#
+# You may specify an explicit list of local users to chroot() to their home
+# directory. If chroot_local_user is YES, then this list becomes a list of
+# users to NOT chroot().
+# (Warning! chroot'ing can be very dangerous. If using chroot, make sure that
+# the user does not have write access to the top level directory within the
+# chroot)
+#chroot_local_user=YES
+#chroot_list_enable=YES
+# (default follows)
+#chroot_list_file=/etc/vsftpd.chroot_list
+#
+# You may activate the "-R" option to the builtin ls. This is disabled by
+# default to avoid remote users being able to cause excessive I/O on large
+# sites. However, some broken FTP clients such as "ncftp" and "mirror" assume
+# the presence of the "-R" option, so there is a strong case for enabling it.
+#ls_recurse_enable=YES
+#
+# Customization
+#
+# Some of vsftpd's settings don't fit the filesystem layout by
+# default.
+#
+# This option should be the name of a directory which is empty.  Also, the
+# directory should not be writable by the ftp user. This directory is used
+# as a secure chroot() jail at times vsftpd does not require filesystem
+# access.
+secure_chroot_dir=/var/run/vsftpd/empty
+#
+# This string is the name of the PAM service vsftpd will use.
+pam_service_name=vsftpd
+#
+# This option specifies the location of the RSA certificate to use for SSL
+# encrypted connections.
+rsa_cert_file=/etc/ssl/certs/ssl-cert-snakeoil.pem
+rsa_private_key_file=/etc/ssl/private/ssl-cert-snakeoil.key
+ssl_enable=NO
+
+#
+# Uncomment this to indicate that vsftpd use a utf8 filesystem.
+#utf8_filesystem=YES