Vultr DocsLatest Articles

How to Install Ackee Analytics on Ubuntu 20.04

NGINXUbuntuAckee Analytics
HM
Updated on July 25, 2024
How to Install Ackee Analytics on Ubuntu 20.04 header image

Ackee is a self-hosted analytics tool built on Node JS. It is a Google Analytics alternative, privacy-focused, and offers a minimal straightforward web interface for analyzing website traffic with helpful insights. This article will teach you how to install and set up Ackee Analytics on a Ubuntu 20.04 Server.

Prerequisites

Installation

Install Yarn.

$ sudo npm install –global yarn

Check the installation.

$ sudo yarn --version

Then, clone the Ackee Analtyics Github Repository.

$ git clone https://github.com/electerious/Ackee

Switch to the new Ackee Directory.

$ cd Ackee

Setup a new .env file using your preferred text editor.

$ nano .env

Paste the following configurations: Replace example, password with your preferred username and a strong password.

ACKEE_MONGODB=mongodb://localhost:27017/ackee
ACKEE_USERNAME=Example
ACKEE_PASSWORD=password

Save and close the file.

Now, install Ackee using yarn:

$ sudo yarn install

Setup Ackee Analytics as a system service

Create a new Systemd service file.

$ sudo nano /etc/systemd/system/ackee.service

Paste the following configurations to the file:

[Unit]
Description=Ackee Analytics
After=network.target

[Service]
Type=simple
User=example
WorkingDirectory=/home/example/Ackee

ExecStart=yarn start

[Install]
WantedBy=multi-user.target

Save and close the file.

Enable the Ackee Analytics Service.

$ sudo systemctl enable ackee.service

Restart the Systemd daemon to load changes.

$ sudo systemctl daemon-reload

Start Ackee Analytics.

$ sudo systemctl start ackee

Setup Nginx as a reverse proxy

Create a new Nginx configuration file.

$ sudo nano /etc/nginx/sites-available/analytics.example.com

Paste the following configurations:

server {
    listen 80;
    listen [::]:80;
    
     server_name analytics.example.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;

    }
}

Save and close the file.

Replace `analytics.example.com with your active domain name pointed to the server.

Enable the configuration file by linking it to /sites-enabled with the following command:

$ sudo ln -s /etc/nginx/sites-available/analytics.example.com /etc/nginx/sites-enabled/

Check the Nginx configuration for errors.

$ sudo nginx -t

Restart Nginx.

$ sudo systemctl restart nginx

Setup Ackee Analytics

Using a web browser, visit your configured domain name.

http://analytics.example.com

Now, enter the administrator username and password you configured earlier in the .env file.

Once successful, navigate to the Settings tab and click New domain to add a new website to track. Next, copy the tracking code, and paste it to your website’s <head> section to track all visitors with Ackee Analytics.

The Ackee Analytics Interface

Conclusion

Congratulations, you have successfully installed Ackee Analytics on Ubuntu 20.04. You can add multiple domains to track within the application through the web interface. For further information on using Ackee Analytics, refer to the official documentation page.