This setup is very flexible, allowing you to run everything on a single server or VM. It is good option if you have spare capacity on an existing machine.

This approach requires you to manually track new releases and update the binary yourself every time.

​
Supported Platforms

Platform nameDescription
linux_amd64Linux AMD64
linux_arm64Linux ARM64
osx_amd64macOS 12+ (Intel CPUs)
osx_arm64macOS 12+ (Apple Silicon: M1, M2 CPUs, etc.)
windowsUnsupported. Consider using Docker instead.
The binary is compatible with most Linux distributions by default, including Ubuntu, CentOS, and Debian. For minimal environments, ensure the libstdc++6 package and its dependencies are installed.

​
Installation

1

Download

Get the latest version of the binary from GitHub Releases that matches your operating system.

2

Run Program

Save the binary in a suitable location, then run the program with the following start command:

./<path-to-executable> start

On the first run, this will create two database files in the same directory as the binary: me_meta.db and me_analytics.db. Ensure these files are kept in persistent storage.

3

Configure Deployment

Before you can start collecting data, you may want to configure your analytics instance to suit your needs. It is recommended to refer to the CLI Configuration page for more details.

Afterwards, ensure your analytics instance is configured to be accessible from the internet. You must also set up SSL certificates for your deployment.

4

Add Your First Website

Success! You can now add your first website to the analytics instance by visiting the web interface at http://localhost:8080 or the publicly accessible hostname for your deployment.

The default login credentials are:

  • Username: admin
  • Password: CHANGE_ME_ON_FIRST_LOGIN
To successfully login, you must either use localhost or a HTTPS connection. Logging in via an unencrypted HTTP connection will not work.
It is recommended to change the username and password immediately after logging in for the first time. This can be changed in the settings menu.
5

Embed Tracking Snippet

Then, embed the following HTML tracking snippet in the <head> element of your website to start collecting data:

<script defer src="https://[your-public-api-hostname].com/script.js"></script>
Learn more about configuring your tracking snippet here.
InstallationDocker