Create your Convex account and deploy key
Convex is where your copy of RankBull lives: your database, your backend, your account. RankBull's installer needs one thing from it — a project deploy key — and this page is every click to get one. Three minutes, free tier, no card.
What you'll need
- An email address or GitHub account to sign up with
The steps
about 3 minutes of your timeCreate the account
Go to convex.dev and sign up — GitHub or email, either works. The free tier is all RankBull needs for typical use; you don't enter a card.
convex.dev → Sign up
Create a project
Make a new project and name it anything — "rankbull" is a fine choice. The name is only for you.
Switch to Production
Inside your project, open the deployment dropdown at the top of the Convex dashboard and choose Production. That's the deployment RankBull installs to — generating the key anywhere else gives the installer the wrong target.
Top dropdown → Production
Generate a project deploy key — with all permissions
Open the project's Settings and find Deploy keys (Convex sometimes calls these project tokens). Click Generate — a permissions panel slides in from the right; select ALL the permissions, then create the key and copy it. The installer needs to both read and write your project's settings, so a partial-permission key is the most common cause of a failed install. The key is stored encrypted and never shown to anyone.
Settings → Deploy keys → Generate → select all permissions → copy
Paste it into the setup wizard
Back in rankbull.io/setup, paste the key and the install starts immediately. You'll watch five live progress steps; the whole install usually takes 2–4 minutes and verifies itself before reporting done.
Questions & troubleshooting
Setup says my key "can't change your project's settings" — what's wrong?
Either the key is deployment-scoped instead of project-scoped, or it was generated without all permissions selected. In Convex, make sure Production is selected in the top dropdown, open Settings → Deploy keys, generate a project-scoped key (sometimes called a project token) with ALL permissions ticked in the slide-in panel, and paste the new one. This is the single most common setup hiccup and the fix takes thirty seconds.
Is the free tier really enough?
For typical use, yes — RankBull was built for it, right down to scheduling its own cleanup jobs so storage doesn't creep. If your usage ever outgrows it, you'd upgrade your own Convex plan directly with them; RankBull charges nothing either way.
Can I rotate the key later?
Yes. Generate a fresh key in Convex and re-run setup at rankbull.io/setup with it — the wizard recognises an existing installation and just swaps the key. Nothing is reinstalled and no data is touched.
One payment. Your infrastructure. Every update included.
Everything you just read is the whole setup — there is no hidden part.