Install in 10 minutes
Install ArghBox, a free self-hosted feedback widget, on any shared PHP host in about 10 minutes. This is the short version. The full walkthrough, with Hostinger specifics and troubleshooting, is the install guide on GitHub.
Works on static sites, WordPress, Next.js, any shared PHP hosting
What you need
- A website where you can add one line of HTML.
- Hosting with PHP 8.1 or newer and SQLite (almost every host has both), and a file manager or FTP.
- A free Cloudflare account, only for Turnstile. Your domain does not have to be on Cloudflare.
- Node.js 22 or newer on your own computer, for the helper tools and the triage skill. Node never runs on the server.
The steps
1. Create a Turnstile widget
In the Cloudflare dashboard open Turnstile, add a widget for your domain (mode Managed) and copy the site key and the secret key.
2. Get the code, make your secrets, write config.php
Get the ArghBox repository: git clone, or GitHub's Code, then Download ZIP. In it, run the command below. It prints a secret and two tokens (owner and triage). Save the tokens in your password manager now, they are shown once. Then copy arghbox/config.example.php to config.php and fill it in.
node tools/new-secrets.mjs3. Upload the folder
Upload the arghbox/ folder to your web root (File Manager or FTP), so it ends up at https://your-site/arghbox/. Keep the hidden .htaccess files. Put config.php in an arghbox-private/ folder next to public_html, where the web cannot reach it.
If your site lives in a Git repository, this copies the folder and the triage skill for you, and you can run it again later to upgrade:
node tools/install.mjs --target <site repo> --public <public dir> --skill4. Check the health
Open /arghbox/api.php?action=health on your site. Check that config is "found", config_valid is true and sqlite shows a version.
5. Add the script tag
Put this on every page where you want the Feedback tab:
<script src="/arghbox/arghbox.js?v=0.1.0" defer></script>Change the ?v= number when you upgrade, so browsers fetch the new files.
6. Empty the box with your own AI
Copy the triage skill into your site repository (the install command above does it with --skill), save the triage token in .arghbox/token and your site address in .arghbox/site.json, then tell Claude Code:
Empty the ArghBox.It rejects spam, merges duplicates, tags the rest and flags what needs you. Everything is logged and can be undone.
Behind Cloudflare?
Set 'trusted_ip_header' => 'HTTP_CF_CONNECTING_IP' in config.php, so rate limits see real visitors, and make sure the API is never cached.
Try it first, read more
- Play with the live demo: add an argh, run triage, see the clean list.
- On your own machine,
npm run devin the repository starts a demo site, a fake Turnstile and a seeded box. - Configuration, triage, MCP and integrations are documented on GitHub.