How to Install Umami Analytics on Debian 12

Introduction

Umami is a simple and elegant open-source web analytics solution. This tutorial will guide you through the process of installing Umami Analytics on Debian 12.

Prerequisites

Before you begin, ensure you have:

1. A Debian 12 server or desktop system
2. Node.js installed on your system. You can install Node.js using the following command:

sudo apt update
sudo apt install -y nodejs npm

Step 1: Clone Umami Repository

Clone the Umami repository from GitHub:

git clone https://github.com/mikecao/umami.git

Step 2: Navigate to Umami Directory

Change into the Umami directory:

cd umami

Step 3: Install Dependencies

Install Umami dependencies using npm:

npm install --production

Step 4: Configure Umami

Edit the .env file to configure Umami:

nano .env

Update the following settings:

BASE_URL=http://your_domain.com
DATABASE_URL=sqlite://./umami.sqlite

Step 5: Build and Run Umami

Build and run Umami:

npm run build
npm start

Step 6: Access Umami

Open a web browser and navigate to the base URL you configured in the .env file (e.g., http://your_domain.com) to access Umami Analytics.

Conclusion

Congratulations! You have successfully installed Umami Analytics on Debian 12. You can now use Umami to track and analyze website traffic.