Ansible Role: Fathom
Installs Fathom, a Go-based website analytics system.
After the playbook is finished, visit the fathom interface (on port 9000 by default), and you can see instructions for configuring websites to send analytics to your Fathom server.
N/A, though you may wish to also install and configure Nginx as a proxy for security and stability reasons, and Certbot to acquire and use a valid TLS certificate for HTTPS (recommended roles:
Available variables are listed below, along with default values (see
The URL from which Fathom will be downloaded. Override for a newer or different version, or to lock in a specific version.
If changing versions, use this flag to force Ansible to change Fathom versions on the server.
fathom_manage_service: true fathom_service_state: started fathom_service_enabled: true fathom_service_user: root
Fathom service controls; useful if you want to stop the service, not have it enabled at boot, or are running Fathom inside a container where the service configuration is not helpful.
The directory inside which Fathom configuration and the default SQLite database are stored.
fathom_http_port: "9000" fathom_database_name: fathom.db fathom_secret: secret-string-here
Fathom configuration options. Make sure you override
fathom_secret in your playbook for better security!
- hosts: analytics vars_files: - vars/main.yml roles: - geerlingguy.fathom
Use with Nginx as a proxy
Note that you can also add the role
geerlingguy.certbot if you want to install certbot and configure a default certificate to work with the Nginx server configuration for HTTPS on your Fathom installation.
MIT / BSD