Fathom Analytics
Open Source Alternative to Google AnalyticsREAMDE.md
Fathom Lite - simple website analytics
Fathom Lite is a previous and open-source version of Fathom Analytics (a paid, hosted Google Analytics alternative). It was the very first version of our software, and has been downloaded millions of times!
While we are no longer adding features to this Lite version, we will be continuing to maintain it long-term and fix any bugs that come up.
Fathom Lite vs Fathom Analytics
Fathom Analytics is much more detailed, feature-rich, and even more focused on privacy-law compliance, than Fathom Lite.
If you’d like to become a customer of Fathom Analytics, and not have to worry about servers, maintenance, security, you can give our software a try with a 30-day free trial (this link will give you $10 credit).
| Lite | Pro |
|---|---|
| Uses Cookies | Cookie-free |
| - | EU Isolation |
| - | Bypass ad-blockers |
| - | Email reports |
| - | Track event completions |
| - | Share your dashboard publicly or privately |
| - | Track UTM campaigns |
| - | Device, Browser & Country Data |
| No support | Fast and responsive support from the Fathom founders |
| No guaranteed uptime | Fully redundant cloud-based architecture that keeps your analytics online |
| Scaling requires you to power down and then upgrade your server | On-demand, automatic scaling, so even if your site goes viral, your stats won’t stop or slow down - we handle billions of page views each month |
| Manual backups by you | Real time backups included in the cost |
| No data protection | Continuous data protection (in the event of a database hardware failure, we have a live standby database ready to failover to) |
| Manual updates, via the command line | Automatic updates, patches and new versions at no extra cost, no coding required |
| Manual server hardening for security | Totally secure servers, monitored and maintained by us, included in the price |
| You pay for hosting, you do all the work to maintain the server, the code and backups | You pay us, we take care of everything for you |
| Embed script served via single server, from a single geographical location | Embed script served via our super-fast CDN, with endpoints located around the world to ensure fast page loads |
| Data aggregation performed on a single server | Super fast data-aggregation spread across our cloud architecture |
| Fork this repo | Supporting a privacy-focused, indie software company |
| Offered as-is | New features added all the time |
| - | Get started for free |
Installation
Production
You can install Fathom on your server by following our simple instructions.
Development
For getting a development version of Fathom up & running, go through the following steps.
- Ensure you have Go and NPM installed
- Download the code:
git clone https://github.com/usefathom/fathom.git $GOPATH/src/github.com/usefathom/fathom - Compile the project into an executable:
make build - (Optional) Set custom configuration values
- (Required) Register a user account:
./fathom user add --email=<email> --password=<password> - Start the webserver:
./fathom serverand then visit http://localhost:8080 to access your analytics dashboard
Docker
Building
Ensure you have Docker installed and run docker build -t fathom ..
Run the container with docker run -d -p 8080:8080 fathom.
Running
To run our pre-built Docker image, run docker run -d -p 8080:8080 usefathom/fathom:latest
Tracking snippet
To start tracking, create a site in your Fathom dashboard and copy the tracking snippet to the website(s) you want to track.
Content Security Policy
If you use a Content Security Policy (CSP) to specify security policies for your website, Fathom requires the following CSP directives (replace yourfathom.com with the URL to your Fathom instance):
script-src: yourfathom.com;
img-src: yourfathom.com;
Copyright and license
MIT licensed. Fathom and Fathom logo are trademarks of Fathom Analytics.