Guides
Single Binary
Self-host on your own platform.
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 name | Description |
|---|---|
linux_amd64 | Linux AMD64 |
linux_arm64 | Linux ARM64 |
osx_amd64 | macOS 12+ (Intel CPUs) |
osx_arm64 | macOS 12+ (Apple Silicon: M1, M2 CPUs, etc.) |
windows | Unsupported. 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 On the first run, this will create two database files in the same directory as the binary:
start command: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
If your hosting provider does not automatically provision SSL certificates to your machine, you may want to use the automatic SSL setup feature.
localhost or a HTTPS connection. Logging in via an unencrypted HTTP connection will not work. If your hosting provider does not automatically provision SSL certificates to your machine, you may want to use the automatic SSL setup feature.
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:Learn more about configuring your tracking snippet here.