Requirements
What you need before you install anything.
Accounts
A Tebex store
Already set up with your categories and packages. Cubed displays what is in Tebex — it does not create products.
A Supabase project
Free tier. Holds your settings and uploaded images. Three minutes to create.
Both are covered on the next two pages: Tebex setup and Set up Supabase.
On your own computer
You need these even if you plan to host somewhere else, because the one-time setup command is much easier to run locally.
| Tool | Version | Why |
|---|---|---|
| Node.js | 24 or newer | The theme's package.json declares "node": ">=24". Older versions refuse to install or fail at build. |
| Bun | 1.2 or newer | Required for the seed command — see below. |
| Git | any recent | To download and update the theme. |
Installing Node.js
Download the LTS build from nodejs.org and run the installer. Then check it worked:
node -vYou should see v24. or higher.
Installing Bun
curl -fsSL https://bun.sh/install | bashClose and reopen your terminal, then check:
bun -vBun is required for setup. The admin panel's command-line tools — the seed
script and type generation — do not run under Node.js 24 on this project, which is
why the theme ships a small Bun launcher (scripts/payload-cli.ts) for them.
You still serve the site with Node.js. Bun is only for setup commands, and you
only need it on the machine where you run bun run seed.
For the machine that will host the site
Memory
At least 1–2 GB free during the build. The site itself runs comfortably in about 512 MB once built.
Disk
About 2 GB for the project and its dependencies.
Node.js 24+
Same requirement as above. Managed hosts like Vercel handle this for you.
No permanent disk needed. Nothing is written to the server — your settings and uploads live in Supabase. That is why serverless hosts work with no extra services.
Outbound internet access
The build downloads the site's fonts from Google Fonts, so the machine doing the build needs internet. Once running, the site talks to these hosts:
| Host | What for | Breaks if blocked |
|---|---|---|
*.pooler.supabase.com | Your database | Everything |
*.supabase.co | Uploaded images and the Storage API | Logo, favicon |
headless.tebex.io | Categories, packages, basket, checkout | The whole store |
plugin.tebex.io | Sale banner, gift-card balance lookup | Sales and gift cards only |
api.frankfurter.app | Exchange rates for the currency switcher | Currency conversion only |
api.mcsrvstat.us | Live player counter on the home page | Player counter only |
mc-heads.net | Player avatar images | Avatars only |
dunb17ur4ymx4.cloudfront.net | Package images hosted by Tebex | Product images |
All plain outbound HTTPS on port 443. If you run a strict firewall, allow them.
What you do not need
- A separate CMS. The admin panel is built in, at
/admin. - A payment provider. Tebex handles all payments and checkout.
- A database server. Supabase is it.
- An S3 or R2 account. Supabase Storage handles uploads.
- A permanent disk on your host. Nothing is stored there.