Pure-FTPd

This is an Ansible Role that installs Pure-FTPd on Debian/Ubuntu systems.

Requirements

You only need specific requirements if you want to enable TLS support and generate a certificate.

• If you set pureftpd_tls_certificate_method to generate, you must have openssl installed on your server.
• If you set it to certbot, make sure certbot is available on the remote server. You can use geerlingguy.certbot to install it.

Role Variables

You can find the available variables and their default values below (in defaults/main.yml):

• pureftpd_packages: List of packages to install with APT (default: pure-ftpd-common, pure-ftpd).

• Global configuration settings:

  • pureftpd_global_config_mode: default is standalone.
  • Other settings regarding uploads and virtual chroot.

• pureftpd_fortune: Set a message to display to users upon login.

• MySQL configuration:

  • You need to provide connection details if you want to store virtual users in a MySQL database.

• PostgreSQL configuration:

  • Similar to MySQL, but for PostgreSQL.

• LDAP configuration:

  • Provide the necessary details if you want to use an LDAP server for virtual user storage.

• pureftpd_config: A long list of configuration options for Pure-FTPd, each with its own purpose (e.g., limiting anonymous access, logging, connection settings).

• pureftpd_auth: Set priorities for various authentication methods.

• pureftpd_system_users: List of system users that should exist.

• pureftpd_virtual_users: Define virtual users with their details (name, password, home directory).

• pureftpd_tls_certificate_method: Choose how to handle TLS certificates (options: certbot, generate, upload).

Dependencies

This role has no additional dependencies.

Example Playbook

Here's how you can use this role in a playbook:

- hosts: webservers
  roles:
     - gcoop-libre.pure-ftpd

License

This role is licensed under GPLv2.

Author Information

This role was created in 2017 by gcoop Cooperativa de Software Libre.