Mirror of Fathom Analytics
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Jack Ellis b683d5606c
Delete DigitalOcean One-Click Installation Instructions.md
1 month ago
assets/src testing fix for issue #77 7 months ago
docs Delete DigitalOcean One-Click Installation Instructions.md 1 month ago
pkg sqlite re-uses ID for columns not marked as autoincrement, so use that. fixes #202 5 months ago
vendor revert updates for packr... 8 months ago
.env.example Adding gzip compression for HTTP and Headers for tracker's sec (#181) 8 months ago
.gitignore move cmd into pkg/cli and simplify entry point. add goreleaser configuration for automated dist releases. 8 months ago
.goreleaser.yml correctly set version, commit & date through ldflags in goreleaser config. closes #186 7 months ago
CODE_OF_CONDUCT.md add code of conduct 1 year ago
Dockerfile Fix issue with packr 4 months ago
LICENSE License holder changed 4 months ago
Makefile specify packr location instead of dotdotdot syntax. closes #196 7 months ago
README.md Removed DO as main installation location 1 month ago
docker-compose.yml Adding gzip compression for HTTP and Headers for tracker's sec (#181) 8 months ago
gulpfile.js show pagination arrows in table component which allows paginating the table results. closes #153 7 months ago
main.go correctly set version, commit & date through ldflags in goreleaser config. closes #186 7 months ago
package-lock.json testing fix for issue #77 7 months ago
package.json rm unused dependencies 7 months ago

README.md

Fathom - simple website analytics (Community Edition)

Donate Go Report Card MIT licensed

Fathom Analytics is a simpler and more privacy-focused alternative to Google Analytics.

Collecting information on the internet is important, but it’s broken. We’ve become complacent in trading information for free access to web services, and then complaining when those web services do crappy things with that data.

The problem is this: if we aren’t paying for the product, we are the product.

Google Analytics may give you free access to their services but in turn, they’re assembling data profiles on your website visitors, which they can then use for better targeting of advertisements across their network.

We need to stop giving away our data and our users’ privacy for free access to a tool.

Fathom respects the privacy of your users and does not collect any personally identifiable information. All while giving you the information you need about your site, so you can make smarter decisions about your design and content.

Screenshot of the Fathom dashboard

Community Edition vs PRO Edition

We offer a PRO version of Fathom Analytics that starts at $14 / month. You can also self-host our Community Edition on your own server (est. $5 / month).

Open Source Paid/Hosted
No support (you can post an issue to our repo) Fast and responsive support from the Fathom founders
No guaranteed uptime Fully redundant cloud-based architecture that keeps your stats 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 can handle billions of page views each month
Manual backups, if you know how to set them up on your server 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 go)
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 server, monitored and maintained by us, included in the price
You pay for hosting, you have to do all the work to maintain the server, the code and backups You pay us, we take care of everything for you
Tracker file served via single server, from a single location Tracker file 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
Contribute to our repo Supporting a privacy-focused, indie software company
Buy now

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;

Roadmap

Find our public roadmap here.

If you have an idea or suggestion for Fathom, submit it as an issue here on GitHub.

Donation

If you’re self-hosting Fathom Analytics (Community Edition) and want to support it’s development, you can:

paypal

Copyright and license

MIT licensed. Fathom and Fathom logo are trademarks of Fathom Analytics.