> ## Documentation Index
> Fetch the complete documentation index at: https://medama.mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

## 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](/deployment/docker) instead. |

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

## Installation

<Steps>
  <Step title="Download">
    Get the latest version of the binary from [GitHub Releases](https://github.com/medama-io/medama/releases) that matches your operating system.
  </Step>

  <Step title="Run Program">
    Save the binary in a suitable location, then run the program with the following `start` command:

    ```sh theme={null}
    ./<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.
  </Step>

  <Step title="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](/config/cli) 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.
  </Step>

  <Step title="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`

    <Warning>To successfully login, you must either use `localhost` or a `HTTPS` connection. Logging in via an unencrypted `HTTP` connection will not work. <br /><br /> If your hosting provider does not automatically provision SSL certificates to your machine, you may want to use [the automatic SSL setup feature](../deployment/ssl).</Warning>

    <Note>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.</Note>
  </Step>

  <Step title="Embed Tracking Snippet">
    Then, embed the following HTML tracking snippet in the `<head>` element of your website to start collecting data:

    ```html theme={null}
    <script defer src="https://[your-public-api-hostname].com/script.js"></script>
    ```

    <Info>Learn more about configuring your tracking snippet [here](/config/tracking-snippet).</Info>
  </Step>
</Steps>
