[{"data":1,"prerenderedAt":185},["ShallowReactive",2],{"seo-verification":3,"blog-self-host-wakapi-vps-coding-stats-ma-en":6,"promo-bar-likely":184},{"google":4,"bing":5},"EycwPY2XMyTkVzas3n1ygeNJFGAH513qrMjfDljzsMQ","",{"key":7,"data":8},"blog-self-host-wakapi-vps-coding-stats-ma-en",{"id":9,"slug":10,"slugs":11,"title":15,"excerpt":16,"readTime":17,"views":18,"isPinned":19,"noindex":19,"publishedAt":20,"updatedAt":21,"category":22,"categories":28,"featuredImage":30,"bgImage":31,"posterImage":32,"relatedSolution":33,"intro":36,"keyPoints":37,"sections":38,"ctaTitle":118,"ctaBody":119,"ctaButton":120,"ctaUrl":121,"relatedPosts":122},578,"self-host-wakapi-vps-coding-stats",{"fr":12,"en":10,"ar":13,"es":14},"self-host-wakapi-vps","استضافة-wakapi-على-vps","autoalojar-wakapi-vps-estadisticas-programacion","Wakapi on a VPS: self-hosted coding-time statistics","Install Wakapi on a VPS with Docker Compose: a WakaTime-compatible server, coding time per project and language, closed sign-ups and HTTPS with nginx.",6,0,false,"2026-11-13T00:00:00+00:00","2026-11-14T21:12:37+00:00",{"id":23,"name":24,"slug":25,"color":26,"icon":27},7,"Self-hosting","self-hosting","bg-indigo-500\u002F10 text-indigo-400","cloud",[29],{"id":23,"name":24,"slug":25,"color":26,"icon":27},null,"\u002Fblog\u002Fcovers\u002Fbg.svg","\u002Fblog\u002Fcovers\u002Fself-host-wakapi-vps-poster.svg",{"categorySlug":34,"appSlug":35},"development","wakapi","WakaTime plugins measure coding time very well, but they send every open file, project and branch to a third-party service. Wakapi is an open-source server compatible with those same plugins: you change one configuration line and your statistics stay on your VPS. This guide installs it with Docker Compose, closes sign-ups, publishes it over HTTPS behind nginx and connects your editor.",[],[39,43,53,80,83,99,103,106,109,112,115],{"type":40,"title":41,"body":42},"h2","What Wakapi does","Wakapi receives the heartbeats that WakaTime plugins send while you code: the file, project, language, editor, machine and branch, roughly every two minutes. It aggregates them into statistics you can browse in a web dashboard and through an API compatible with WakaTime's.\n\nThe project is released under the MIT licence. It is a single Go application and stores its data in SQLite by default (MySQL and PostgreSQL are also supported). On a VPS it uses about 100 MB of memory at rest.",{"type":44,"title":45,"items":46},"ul","What Wakapi gives you",[47,48,49,50,51,52],"**Time per project, language, editor, machine and branch** — over the day, the week or any period you choose.","**Your current plugins** — VS Code, JetBrains, Vim, Neovim, Sublime Text: only the server address changes.","**A WakaTime-compatible API** — status bars and tools that read the WakaTime API point to your instance.","**Invite-only accounts** — public sign-ups closed, single-use invite links valid for 24 hours.","**Import of your history** — from WakaTime or another Wakapi instance, in the settings.","**Data that stays with you** — nothing leaves the VPS unless you turn on the WakaTime relay.",{"type":54,"title":55,"headers":56,"rows":59},"comparison","Hosted WakaTime or Wakapi on your VPS",[5,57,58],"WakaTime (hosted service)","Wakapi on your VPS",[60,64,68,72,76],[61,62,63],"Where heartbeats go","WakaTime's servers","Your VPS",[65,66,67],"Editor plugins","WakaTime plugins","The same plugins",[69,70,71],"History kept","Depends on the plan","As long as you keep it",[73,74,75],"Team accounts","WakaTime accounts","Accounts on your instance, by invitation",[77,78,79],"Server licence","Proprietary service","MIT",{"type":40,"title":81,"body":82},"Prerequisites","An Ubuntu 24.04 VPS with **1 GB of RAM and 1 vCPU** is plenty. You need Docker with the Compose plugin, nginx and certbot on the host, and a name (`wakapi.example.com` in this guide) pointing to the VPS's IP. WakaTime plugins send their data over HTTPS: set up the certificate from the start.",{"type":84,"title":85,"steps":86},"steps","Install Wakapi with Docker Compose",[87,90,93,96],{"title":88,"body":89},"Prepare the folder and the .env file","`WAKAPI_PASSWORD_SALT` is the salt added to passwords before hashing: generate it once and never change it, or no account will be able to log in again. Sign-ups stay open just long enough to create your account, then they are closed in step 4.\n```bash\nmkdir -p \u002Fopt\u002Fwakapi && cd \u002Fopt\u002Fwakapi\ncat > .env \u003C\u003CEOF\nDOMAIN=wakapi.example.com\nWAKAPI_PASSWORD_SALT=$(openssl rand -hex 32)\nWAKAPI_ALLOW_SIGNUP=true\nEOF\nchmod 600 .env\n```",{"title":91,"body":92},"Write the docker-compose.yml file","The official image runs as an unprivileged user and keeps its SQLite database in the `wakapi-data` volume. The port is published on the loopback interface only: nginx alone faces the Internet. `WAKAPI_LEADERBOARD_ENABLED` turns off the public leaderboard, and `WAKAPI_INSECURE_COOKIES` set to `false` restricts session cookies to HTTPS.\n```yaml\nservices:\n  wakapi:\n    image: ghcr.io\u002Fmuety\u002Fwakapi:2.18.2\n    restart: unless-stopped\n    environment:\n      WAKAPI_PASSWORD_SALT: \"${WAKAPI_PASSWORD_SALT}\"\n      WAKAPI_PUBLIC_URL: \"https:\u002F\u002F${DOMAIN}\"\n      WAKAPI_ALLOW_SIGNUP: \"${WAKAPI_ALLOW_SIGNUP:-false}\"\n      WAKAPI_INVITE_CODES: \"true\"\n      WAKAPI_LEADERBOARD_ENABLED: \"false\"\n      WAKAPI_INSECURE_COOKIES: \"false\"\n    ports:\n      - \"127.0.0.1:3000:3000\"\n    volumes:\n      - wakapi-data:\u002Fdata\n\nvolumes:\n  wakapi-data: {}\n```",{"title":94,"body":95},"Start and create your account","Start the stack and check the health endpoint, which should answer `app=1` and `db=1`:\n```bash\ndocker compose up -d\ncurl -s http:\u002F\u002F127.0.0.1:3000\u002Fapi\u002Fhealth\n```\nOnce nginx and the certificate are in place (next section), open `https:\u002F\u002Fwakapi.example.com\u002Fsignup` and create your account: the first account created becomes administrator.",{"title":97,"body":98},"Close sign-ups","As soon as your account exists, close sign-ups and recreate the container:\n```bash\nsed -i 's\u002F^WAKAPI_ALLOW_SIGNUP=true\u002FWAKAPI_ALLOW_SIGNUP=false\u002F' .env\ndocker compose up -d\n```\nThe sign-up form now answers \"registration is disabled\". To add a colleague, generate an invite link from your account settings (\"Invite Friends\"): it is valid for 24 hours and works only once.",{"type":100,"title":101,"body":102},"tip","Do not leave sign-ups open","An instance published on a domain with `WAKAPI_ALLOW_SIGNUP=true` lets anyone open an account and store data on it. Keep `false`, invite colleagues by link, and leave the port on `127.0.0.1`.",{"type":40,"title":104,"body":105},"Publish Wakapi over HTTPS with nginx","Create `\u002Fetc\u002Fnginx\u002Fsites-available\u002Fwakapi` with this server block, then enable it with a symbolic link in `sites-enabled`:\n```nginx\nserver {\n    listen 80;\n    server_name wakapi.example.com;\n\n    location \u002F {\n        proxy_pass http:\u002F\u002F127.0.0.1:3000;\n        proxy_set_header Host $host;\n        proxy_set_header X-Real-IP $remote_addr;\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n        proxy_set_header X-Forwarded-Proto $scheme;\n    }\n}\n```\nCheck the configuration, reload nginx and request the certificate; certbot adds the HTTPS block and the redirect from HTTP itself.\n```bash\nsudo nginx -t && sudo systemctl reload nginx\nsudo certbot --nginx -d wakapi.example.com\n```",{"type":40,"title":107,"body":108},"Connect your editor","Install your editor's WakaTime plugin from its usual marketplace. In Wakapi, open the settings and copy your API key, then write the `~\u002F.wakatime.cfg` file on your machine:\n```ini\n[settings]\napi_url = https:\u002F\u002Fwakapi.example.com\u002Fapi\napi_key = \u003CAPI_KEY>\n```\nThe WakaTime client derives the project name from the root folder of the Git repository and the machine name from the host name: your repositories appear as they are in the dashboard, and you tell the laptop from the desktop without effort. A `.wakatime-project` file at the root of a repository forces another project name, useful when several clones share the same folder name. To leave out a sensitive folder, the `exclude` key of `~\u002F.wakatime.cfg` accepts regular expressions on paths.\n\nCode for a few minutes and reload Wakapi's dashboard: your first figures appear. The same file serves every plugin on the machine. To send your data to both WakaTime and Wakapi, the WakaTime client accepts an `[api_urls]` section that adds destinations.",{"type":40,"title":110,"body":111},"Read your statistics and the API","The dashboard shows time per project, language, editor, operating system, machine and branch, over the chosen interval. The same figures are available through the WakaTime-compatible API, with Basic authentication using the base64-encoded API key:\n```bash\ncurl -s https:\u002F\u002Fwakapi.example.com\u002Fapi\u002Fcompat\u002Fwakatime\u002Fv1\u002Fusers\u002Fcurrent\u002Fstatusbar\u002Ftoday \\\n  -H \"Authorization: Basic $(printf %s '\u003CAPI_KEY>' | base64)\"\n```\nThis is the endpoint read by plugins that show today's time in the status bar. The settings also offer README badges, public sharing of selected statistics (off by default) and the import of your WakaTime history.",{"type":40,"title":113,"body":114},"Back up and update","All the data lives in the `wakapi-data` volume. Stop the container while you copy the SQLite database, so that the copy is consistent:\n```bash\ncd \u002Fopt\u002Fwakapi\ndocker compose stop wakapi\ndocker run --rm -v wakapi_wakapi-data:\u002Fdata -v \"$PWD\":\u002Fbackup alpine:3.22 \\\n  tar czf \u002Fbackup\u002Fwakapi-$(date +%F).tar.gz -C \u002Fdata .\ndocker compose start wakapi\n```\nTo update, first read the release notes on GitHub, back up, then change the image tag:\n```bash\ncd \u002Fopt\u002Fwakapi\nsed -i 's|wakapi:2.18.2|wakapi:\u003CNEW_VERSION>|' docker-compose.yml\ndocker compose pull && docker compose up -d\n```",{"type":40,"title":116,"body":117},"Install Wakapi in one click on ServOrbit","On a ServOrbit VPS, Wakapi installs from the Marketplace. The script deploys the official image, generates the administrator password and the hashing salt, creates the `admin` account, closes public sign-ups and turns off the public leaderboard, then configures the nginx reverse proxy over HTTPS — on a subdomain of one of your domains or on the VPS's free subdomain. You log in with the user `admin` and the password shown in your client area, then connect your editor as above.","Your coding statistics on your VPS","A ServOrbit Ubuntu 24.04 VPS with 1 GB of RAM is enough for Wakapi. One-click installation from the Marketplace, HTTPS on your domain or on the VPS's free subdomain, administrator account created for you.","Install Wakapi","\u002Fapplications\u002Fdevelopment\u002Fwakapi",[123,146,165],{"id":124,"slug":125,"slugs":126,"title":130,"excerpt":131,"readTime":132,"views":23,"isPinned":19,"noindex":19,"publishedAt":133,"updatedAt":134,"category":135,"categories":141,"featuredImage":30,"bgImage":31,"posterImage":143,"relatedSolution":144},301,"install-code-server-vps",{"fr":127,"en":125,"ar":128,"es":129},"installer-code-server-vps","تثبيت-code-server-vps","instalar-code-server-vps","Code Server on VPS: VS Code in Your Browser, Self-Hosted","Code Server (MIT, 79 k stars): run VS Code in your browser on your VPS — persistent workspace, password-protected, no local IDE setup needed.",3,"2026-08-24T00:00:00+00:00","2026-11-04T16:30:27+00:00",{"id":136,"name":137,"slug":138,"color":139,"icon":140},4,"Development","developpement","bg-warning\u002F10 text-warning","dev",[142],{"id":136,"name":137,"slug":138,"color":139,"icon":140},"\u002Fblog\u002Fcovers\u002Finstaller-code-server-vps-poster.svg",{"categorySlug":34,"appSlug":145},"code-server",{"id":147,"slug":148,"slugs":149,"title":153,"excerpt":154,"readTime":155,"views":156,"isPinned":19,"noindex":19,"publishedAt":157,"updatedAt":158,"category":159,"categories":160,"featuredImage":30,"bgImage":31,"posterImage":162,"relatedSolution":163},74,"host-gitea-on-your-own-vps",{"fr":150,"en":148,"ar":151,"es":152},"heberger-gitea","استضافة-gitea-على-خادم-vps-الخاص-بك","alojar-gitea-en-un-vps","Host Gitea on your own VPS in 2026","Deploy Gitea 1.25 on a VPS with Docker and SSL. Full guide: Gitea Actions CI\u002FCD, Gitea vs Forgejo v16 comparison, daily administration, SSH and HTTPS troubleshooting.",13,1,"2026-04-07T00:00:00+00:00","2026-11-08T16:32:50+00:00",{"id":23,"name":24,"slug":25,"color":26,"icon":27},[161],{"id":23,"name":24,"slug":25,"color":26,"icon":27},"\u002Fblog\u002Fcovers\u002Fheberger-gitea-poster.svg",{"categorySlug":34,"appSlug":164},"gitea",{"id":166,"slug":167,"slugs":168,"title":172,"excerpt":173,"readTime":174,"views":175,"isPinned":19,"noindex":19,"publishedAt":176,"updatedAt":177,"category":178,"categories":179,"featuredImage":30,"bgImage":31,"posterImage":181,"relatedSolution":182},250,"self-host-glitchtip-on-a-vps-a-sovereign-error-tracker",{"fr":169,"en":167,"ar":170,"es":171},"self-host-glitchtip-vps","تثبيت-glitchtip-على-vps-تتبع-الأخطاء-بشكل-مستقل","instalar-glitchtip-en-un-vps","Self-host GlitchTip on a VPS: a sovereign error tracker","Deploy GlitchTip v6 on a Linux VPS with Docker Compose. Sentry SDK-compatible, 2 GB RAM, Slack\u002Fntfy alerts, sentry-python and @sentry\u002Freact code examples included.",9,2,"2026-08-13T00:00:00+00:00","2026-11-10T14:39:01+00:00",{"id":136,"name":137,"slug":138,"color":139,"icon":140},[180],{"id":136,"name":137,"slug":138,"color":139,"icon":140},"\u002Fblog\u002Fcovers\u002Fself-host-glitchtip-vps-poster.svg",{"categorySlug":34,"appSlug":183},"glitchtip",true,1794785358195]