How to Install Umami on Fedora CoreOS Latest

Umami is a self-hosted analytics platform for websites. In this tutorial, we will learn how to install Umami on Fedora CoreOS Latest.

Prerequisites

Before we begin the installation process, make sure you have the following:

Access to the terminal as a root or a user with administrative privileges

Step 1: Create a User for Umami

Create a user named "umami" for running the Umami application. Enter the command below to create the user:

sudo useradd -r -m -U -d /opt/umami -s /usr/sbin/nologin umami

Step 2: Install Required Packages

Next, install the required packages for Umami to run. Enter the following command to install them all:

sudo dnf install -y curl vim git

Step 3: Install Node.js

Umami requires Node.js to run. Install it by running the following command:

sudo dnf install -y nodejs

Verify the installation by running node -v.

Step 4: Install Yarn

Yarn is also required to run Umami. Install it by running the following command:

sudo npm install -g yarn

Verify the installation by running yarn -v.

Step 5: Clone Umami Repository

Clone the Umami repository into the /opt/umami directory using the following command:

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

Step 6: Install Umami Dependencies

Install Umami dependencies by running the following commands:

cd /opt/umami
sudo yarn install --production --pure-lockfile

Step 7: Create .env File

Create a .env file in the /opt/umami directory with the following command:

sudo vim /opt/umami/.env

Enter the following configuration information:

PORT=3000
DATABASE_URL=mysql://umami:PASSWORD@localhost:3306/umami

Replace PASSWORD with a strong password.

Step 8: Install MariaDB

Umami requires a database to store analytics data. Install MariaDB by running the following command:

sudo dnf install -y mariadb mariadb-server

Step 9: Configure MariaDB

Configure MariaDB to secure the installation and create a new database and user for Umami.

First, start the MariaDB service:

sudo systemctl start mariadb

Next, secure the installation:

sudo mysql_secure_installation

Follow the prompts and answer the questions. Make sure you remember the root password.

Next, log in to the database:

sudo mysql -u root -p

Enter the MariaDB root password when prompted.

Create a new database and user for Umami:

CREATE DATABASE umami;
CREATE USER 'umami'@'localhost' IDENTIFIED WITH mysql_native_password BY 'PASSWORD';
GRANT ALL PRIVILEGES ON umami.* TO 'umami'@'localhost';

Replace PASSWORD with the password used in the .env file.

Exit the database by running:

exit

Step 10: Start Umami

Start Umami by running the following command:

cd /opt/umami
sudo yarn start

Umami will now be available at http://SERVER_IP_ADDRESS:3000.

Conclusion

You have now successfully installed Umami on Fedora CoreOS Latest. Use it to track analytics for your own website.