sabrytarek / fathom

Fathom Lite. Simple, privacy-focused website analytics. Built with Golang & Preact.

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 7-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.

1. Ensure you have Go and NPM installed
2. Download the code: git clone https://github.com/usefathom/fathom.git $GOPATH/src/github.com/usefathom/fathom
3. Compile the project into an executable: make build
4. (Optional) Set custom configuration values
5. (Required) Register a user account: ./fathom user add --email=<email> --password=<password>
6. Start the webserver: ./fathom server and 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.