Logo Wakapi

Development

Wakapi

Wakapi on a VPS: your coding-time statistics, WakaTime-compatible, on your own server — dashboard, API and closed sign-ups.

About Wakapi

Wakapi is an open-source server (MIT licence) that receives the heartbeats sent by your editor's WakaTime plugins — VS Code, JetBrains, Vim, Neovim, Sublime Text and many more — and turns them into statistics: time spent per project, language, editor, machine and branch.

You keep your plugins: you only change the server address in the ~/.wakatime.cfg file. Your data no longer leaves your VPS. The ServOrbit installation creates the administrator account, closes public sign-ups and turns off the public leaderboard: the instance is only open to the people you invite. The data fits in an SQLite database.

What gets installed

Ready when the VPS starts

Compatible OS
Choice of Linux distributions
Application
Wakapi
Tech stack
DockerGoSQLite
Minimum RAM
1 GB minimum
Minimum CPU
1 vCPU
Default port
8119
Access
root over SSH

Key features

  • Compatible with WakaTime plugins — keep your editor and plugins, only change the server address.
  • Coding time per project, language, editor, machine and branch, over any period.
  • A WakaTime-compatible API — status bars and tools that read the WakaTime API work with your instance.
  • Sign-ups closed by default — colleagues join the instance through a single-use invite link.
  • Your data on your VPS — no heartbeat goes to a third-party service, unless you turn on the WakaTime relay.
  • Lightweight — one Go application and an SQLite database, about 100 MB of memory at rest.

When to use this solution?

Measure your own coding time

See how many hours go into each project and language, without sending your file history to a third-party service.

Track time spent per client project

An agency or a freelancer records the time actually spent coding on each project, useful to check an estimate or prepare a time-based invoice.

Give a small team an overview

Each developer has an account on the team's instance, joined by invitation; the data stays on the company's server.

Guide

Deploy Wakapi on your VPS

  1. Create the VPS and choose the address

    Order an Ubuntu 24.04 VPS; 1 GB of RAM and 1 vCPU are enough. Wakapi requires a domain: your plugins send their heartbeats over HTTPS to a stable name, and Wakapi builds its links from that address. It opens on a subdomain of one of your domains, or on the VPS's free subdomain (wakapi.{dns_slug}.servorbit-dns.com), HTTPS included. No need to buy a domain name.

  2. Install Wakapi from the Marketplace

    In your client area, select Wakapi, choose the address and click Install. The script deploys the official image, generates the administrator password and the password-hashing salt, creates the admin account, closes public sign-ups and configures the nginx reverse proxy over HTTPS.

  3. Log in for the first time

    Open https://your-domain/login and log in with the user admin and the password shown in your client area. This account is the instance's administrator; you can change its password from the settings.

  4. Connect your editor

    Install your editor's WakaTime plugin, then copy the API key shown in Wakapi's settings. In the ~/.wakatime.cfg file on your machine: `ini [settings] api_url = https://your-domain/api api_key = <your-api-key>` Code for a few minutes: Wakapi's dashboard shows your first figures.

  5. Invite your team

    Public sign-ups are closed. From your account settings, generate an invite link and send it to your colleague: it is valid for 24 hours and works only once. Everyone then has their own account, API key and statistics.

Frequently asked questions

Questions about Wakapi

← Back to DevelopmentAll applications
Wakapi implements the API used by WakaTime plugins: you keep your plugins and only change the server address in ~/.wakatime.cfg. Your heartbeats are then stored on your VPS. If you want to keep both, the WakaTime client can send the same data to several servers.

Need help?

Browse our help center and FAQ, or reach our team — callback, WhatsApp or email.

Message us on WhatsAppopens in a new tab