How to Install Wakapi on Fedora CoreOS Latest

Wakapi is a free, open-source software that helps users to collect, process, and visualize Wakatime data. In this tutorial, we'll guide you through the steps for installing Wakapi on Fedora CoreOS Latest. Let's get started!

Prerequisites

  1. A running instance of Fedora CoreOS Latest
  2. A stable Internet connection
  3. Basic knowledge of Linux commands
  4. sudo or root privileges

Step 1: Install Docker

Wakapi runs on Docker, so the first step is to install Docker on your server. Follow these commands:

sudo dnf update
sudo dnf install podman-docker

To verify that Docker is installed and running, type the following command:

sudo systemctl status docker

If Docker is running, you should see something like this:

● docker.service - Docker Application Container Engine
   Loaded: loaded (/usr/lib/systemd/system/docker.service; disabled; vendor preset: disabled)
   Active: active (running) [...]

Step 2: Create a Wakapi Configuration File

Wakapi needs a config.yaml file to run. You can use the following config.yaml example as a template:

# config.yaml

# General
debug: false

# Stats
stats:
- label: <Project1>
  tzoffset: 0
  timeout: 1
  maxage: 360
  wakatiwarikey:
  projects:
  - <project1>

- label: <Project2>
  tzoffset: 0
  timeout: 1
  maxage: 360
  wakatiwarikey:
  projects:
  - <project2>

# Database
database:
host: postgresql
port: 5432
user: <dbuser>
password: <dbpassword>
database: <dbname>

Replace <Project1>, <Project2>, <project1>, and <project2> with your actual project names. Replace <dbuser>, <dbpassword>, and <dbname> with your actual database credentials.

Step 3: Launch a PostgreSQL Server

Wakapi requires a PostgreSQL server to store data. If you don't have PostgreSQL installed, follow these steps:

sudo dnf install postgresql-server
sudo postgresql-setup --initdb --unit postgresql
sudo systemctl enable postgresql
sudo systemctl start postgresql
sudo passwd postgres
su - postgres
psql
ALTER USER postgres PASSWORD 'new_password';
\q
exit

Now you need to create a Wakapi database and user. Follow these commands:

su - postgres
createdb wakapi
createuser wakapi
psql
GRANT ALL PRIVILEGES ON DATABASE wakapi TO wakapi;
\q
exit

Step 4: Launch Wakapi

We're almost there! Now it's time to launch Wakapi. Simply run the following command:

sudo docker run \
  --name wakapi \
  --restart unless-stopped \
  --hostname my-wakapi \
  --network host \
  -v $(pwd)/config.yaml:/app/config.yaml \
  -d \
  wakapi/wakapi

This command does the following:

  • Starts a Wakapi container named wakapi
  • Sets the container to automatically restart unless stopped
  • Sets the container hostname to my-wakapi
  • Puts the container on the host network
  • Mounts the config.yaml file in the current directory to /app/config.yaml in the container
  • Runs the container in detached mode (-d)
  • Uses the official Wakapi Docker image (wakapi/wakapi)

That's it! You've successfully installed and launched Wakapi on Fedora CoreOS Latest. You can now access the Wakapi dashboard by visiting http://localhost:3000 in your web browser.