Documentation
Run AnalyticFast on your own Cloudflare account
Deploy analytics into your own Cloudflare account. You need a Cloudflare account, Node.js 18 or newer with npm, and a self-host license from /account/self-host.
Install
Create a new empty folder, open a terminal there and run:
npx create-analyticfast@latest
The operator must publish the npm installer and a release asset before this command works publicly. With a local source checkout, run node /absolute/path/to/AnalyticFast/packages/create-analyticfast/bin/create-analyticfast.mjs from a separate empty installation folder. This fallback still needs a configured license server and software release.
The installer creates one D1 database and one Worker with static assets, applies migrations, sets independent secrets and deploys. If Cloudflare login is missing, run npx wrangler login and rerun. Choose the intended account with CLOUDFLARE_ACCOUNT_ID if you belong to more than one.
The selected account is pinned in installer state. Changing accounts or pointing the saved config at another Worker/database is rejected. Release checksums are verified before extraction.
Save the admin password printed once. Sign in, add a website and copy its tracking snippet. Installer progress and your license are stored in .analyticfast/state.json; keep this private and outside source control. Rerun the same command from the same folder to resume an interruption.
License and hosting
Lifetime is $29 for the first 50 non-refunded lifetime licenses, then $49. Monthly is $5. Your Cloudflare costs are separate. A cancelled or refunded license blocks new release downloads. Your deployed tracking and dashboard continue to work. Offline checks are advisory.
Cloudflare Free currently includes 100,000 Worker requests/day, 5 million D1 rows read/day, 100,000 D1 rows written/day, 500 MB per database, 5 GB total D1 storage and 5 cron triggers per account (AnalyticFast uses 2). These allowances are shared with your other account projects. Exhaustion can interrupt analytics.
Update and backup
Run from the same installation folder:
npx wrangler d1 export DB --remote --output ../analyticfast-backup.sql
npx create-analyticfast@latest update
Store backups securely outside Git. Updates verify your license, download a newer bundle, apply migrations and deploy. Your buyer configuration and secrets are preserved. Keep wrangler.jsonc as valid JSON when using the installer to update it.
Optional integrations
Installer retries verify a deployment marker before changing an existing Worker. Keep ANALYTICFAST_INSTALLATION_ID in the deployed variables and preserve the private .analyticfast/state.json. Choose another name if a Worker belongs to a different installation; never run concurrent installers for the same account/name.
Password login and local analytics work without operator credentials. Google sign-in requires your own OAuth credentials and switching to hosted mode, which changes account/plan behavior. Search Console needs your own Google OAuth setup, email needs your own Resend key and verified sender, and revenue webhooks need your own payment-provider secrets. No operator integration or billing credentials are included.