Wakapi

Development256MB+ RAM

Self-hosted, WakaTime-compatible coding statistics tracker (single container, SQLite)

Download Server Compass Install Wakapi to server

developmentdevtoolswakapiopen-sourceself-hosteddocker

Deploy Wakapi in 3 Steps

Connect Your VPS

Add your server credentials to Server Compass

Select Wakapi

Choose from our template library

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required

Step-by-step deployment guide

Deploy Wakapi on a VPS with Server Compass

Use the Wakapi template in Server Compass to deploy a self-hosted, WakaTime-compatible coding statistics tracker on your VPS, then verify the web UI in a browser.

About 10 minutesBrowser verified

Step 1

Open the server Apps tab

Select the tutorial-vps VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.

Server Compass Apps tab before creating a Wakapi app

Step 2

Choose an app template

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Choosing to deploy an app from a Server Compass template

Step 3

Search for Wakapi

Use the template picker search to find Wakapi in the Server Compass template catalog.

Searching for Wakapi in the Server Compass template picker

Step 4

Select the Wakapi template

Choose the Wakapi template. Server Compass fills the Wakapi web service, SQLite data volume, password salt, public URL, and web port.

Wakapi template selected in Server Compass

Step 5

Review the Wakapi settings

Confirm the app name, web UI port, password salt, and public URL. In this run, the app was named wakapi-demo and used host web port 4067.

Reviewing Wakapi project settings and compose service

Step 6

Deploy Wakapi

Review the generated compose settings, confirm the Wakapi web port is available, and click Deploy.

Reviewing Wakapi web port before deployment

Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the Wakapi image, starts the container, and verifies the stack.

Server Compass deploying the Wakapi template on the VPS

Step 8

Confirm Wakapi is running

After deployment finishes, return to the Apps tab and confirm the Wakapi app is marked Running with its application URL available.

Wakapi template running in the Server Compass Apps tab

Step 9

Open Wakapi in the browser

Open the application URL in a browser. The Wakapi sign-up or login page confirms the coding statistics service is reachable.

The deployed Wakapi web UI loaded in a browser

After Wakapi Opens

Create your first Wakapi user account.
Copy your API key from Settings.
Configure your editor WakaTime plugin to use the Wakapi API URL.
Set WAKAPI_ALLOW_SIGNUP=false after account creation if this is a single-user instance.
Put Wakapi behind HTTPS and update WAKAPI_PUBLIC_URL before relying on it for production stats.
Back up the Wakapi data volume because it stores all coding statistics.

Verified Result

The Wakapi web interface loaded successfully from the deployed container.

Download Server Compass Docs

Wakapi deployment questions

What does the Wakapi template deploy?

It deploys Wakapi as a single-container, WakaTime-compatible coding statistics tracker using SQLite and a persistent data volume.

Which port did the tutorial use?

The tutorial used host port 4067, which maps to the Wakapi web UI on container port 3000.

Does Wakapi need setup after deployment?

Yes. Open the web UI, create an account, copy the API key from Settings, and configure your editor WakaTime plugin to send activity to the Wakapi API.

Should this become a blog post?

No. The deployment guide should live on the Wakapi template detail page and be linked from the reusable template deployment docs page.

After Deployment

After deploying Wakapi with Server Compass, complete these steps to finish setup

Visit the application URL

Copy your API key from Settings

Install the WakaTime plugin in your editor and set api_url to WAKAPI_PUBLIC_URL/api and api_key to your token

Need help? Check out our documentation for detailed guides.

Wakapi FAQ

Common questions about self-hosting Wakapi

How do I deploy Wakapi with Server Compass?

Simply download Server Compass, connect to your VPS, and select Wakapi from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.

What are the system requirements for Wakapi?

Wakapi requires a minimum of 256MB RAM. We recommend a VPS with at least 1024MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing Wakapi data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Wakapi backup and restore procedures.

How do I update Wakapi to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Wakapi image will be pulled and deployed with zero downtime.

Is Wakapi free to self-host?

Wakapi is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.

Related Templates

View all Development

PocketBase

Open-source backend in a single file with realtime database, auth, and file storage

Appwrite

Open-source backend-as-a-service - self-hosted Firebase alternative

Parse Server

Open-source backend framework with dashboard

Supabase

Full Supabase self-hosted with Kong, GoTrue Auth, Realtime, and Studio

Ready to Self-Host Wakapi?

Download Server Compass and deploy Wakapi to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass