Command Reference

Every command below is a Discord slash command — type / in the QuickBox.IO server and Discord filters the list as you type. Commands are grouped by what they do, not by who can run them; the Access column tells you what each one needs.

Start with `/verify`

If you own a QuickBox Pro licence, run /verify before anything else on this page. It is the recommended way to verify, and it is the shortest: a private conversation in your DMs where the bot asks for the email or username on your v3.quickbox.io account, emails you an eight-digit code, and you paste the code back. Nothing is needed from your server, and no keys change hands.

Three things happen when it completes. You get the 🌟Verified role, which is what the Verified commands below check for. Your onboarding quest is closed out for you, so there is nothing else you need to run to get moving. And your Discord account is linked to your QuickBox Pro account — which is the part that saves you work later: from then on /server add reads the active installs already on your licence and offers them to you as a list, instead of asking you to type in a server URL and a read key.

No v3.quickbox.io account yet?

Verification resolves against a v3.quickbox.io account, so you need one. If you are still on the older quickbox.io platform, bring your licence across with the Migration Utility — signing in with Discord while you register does the Discord link for you in the same step. If you would rather verify against your installation instead, /verify-start takes your install details directly.

The full walkthrough, including what to do when the email does not arrive, is on Verifying Your License.

Access is about your role, not where you run it

Commands are gated by who you are — anyone, verified members, or staff — never by which surface you use. If a command is not gated for your role, it appears and works.

Access	What it means
Anyone	Any member of the server
Verified	Requires the 🌟Verified role — see Verifying Your License
Staff	Moderators, admins, or support. Listed here for transparency — they will not appear in your command list if you do not hold the role

Account and verification

Command	Options	Access	What it does
/verify	—	Anyone	Recommended. Verify in a DM conversation using your v3.quickbox.io account and an emailed code. Also links your Discord account to your licence
/verify-start	—	Anyone	Verify against your installation instead — remote URL and read key, or LAN address and API key
/verify-status	—	Anyone	Check your current QuickBox verification status
/account info	`show`	Anyone	View your license, subscription, and verification status
/account link	—	Anyone	Get a direct link to your QuickBox dashboard
/language	—	Anyone	Set your preferred language for bot responses
/user-preference	—	Anyone	View and manage your preferences and saved QuickBox servers

Your servers

Command	Options	Access	What it does
/server add	—	Verified	Link a QuickBox server to your account. If you verified with `/verify`, the active installs on your licence are offered as a list to pick from
/server remove	—	Verified	Unlink a QuickBox server from your account
/server status	`host`, `read_key`, `user`, `show`, `hidden`	Verified	Server health — CPU, RAM, disk, uptime, load, network, pending updates
/server apps	`host`, `read_key`, `user`, `show`	Verified	Installed software with versions and ports, grouped by user
/server alerts	`toggle` (on / off, required)	Verified	Turn DM health alerts on or off for your linked servers
/server debug	`host`, `read_key`, `user`	Staff	Debug server API connectivity
/snapshot run	—	Verified	Comprehensive server health snapshot in one embed
/snapshot detail	—	Staff	Expanded snapshot — top-10 apps and 30-day bandwidth
/system-status	`host`, `read_key`, `user`, `show`, `hidden`	Verified	Remote server system status via the QuickBox API
/system-speedtest	`host`, `read_key`, `user`, `show`, `hidden`	Verified	Runs a speedtest on your server — ping, download, upload, ISP, test server
/uptime	`host`, `read_key`, `show`, `hidden`	Anyone / Verified	Bot uptime with no options; pass a `host` for a server's uptime, which requires the Verified role

host autocompletes

The host option completes from the servers you linked with /server add, so you never have to type an address. user targets another member’s server and is restricted to admins.

Help and documentation

Command	Options	Access	What it does
/help	—	Anyone	Browse application help topics or the full bot command list
/ask	`query` (required), `tier`	Anyone	Ask a question and get a documented answer with its sources
/kb	`query` (required)	Anyone	Search the command and system knowledge base
/troubleshoot	`app` (required), `debug`	Anyone / Verified	Guided diagnostic for one app. Verified members with a linked server get live checks; `debug` is staff-only
/quick-support	`host` (required), `enable`, `disable`, `status`, `dm_staff_member`	Verified	Enable, disable, or check QuickSupport access on your server
/doc-create	`type` (required)	Staff	Create a new help entry

QuickBox releases

Command	Options	Access	What it does
/version	—	Anyone	Current QuickBox.IO version
/changelog	—	Anyone	Changelog for the latest QuickBox.IO version

Feedback and the backlog

Command	Options	Access	What it does
/feature-request list	`sort`, `page`	Anyone	Browse open feature requests sorted by votes, newest, or recently updated
/feature-request view	`id` (required)	Anyone	View details for one feature request
/feature-request status	`status`, `sort`, `page`	Anyone	Browse requests filtered by open, planned, in progress, completed, or closed
/feature-request submit	—	Anyone	Two-step wizard to submit a new feature request
/feature-request mine	—	Anyone	Points you at v3.quickbox.io — per-account filtering is not in Discord yet
/feature-request upvote	`id`	Anyone	Points you at v3.quickbox.io — voting happens in the portal
/bug-report submit	—	Anyone	Guided wizard to report a bug to the QuickBox Pro team
/app-suggestion submit	—	Anyone	Guided wizard to suggest a new application for QuickBox Pro

One submission per type every six hours

/feature-request submit, /bug-report submit and /app-suggestion submit are each limited to one submission every six hours.

Beta Squad

Command	Options	Access	What it does
/beta-apply	—	Verified	Apply to become a Beta Squad member
/beta-view	`user` (staff only)	Verified	View your current Beta Squad installations
/beta-remove	`user` (staff only)	Verified	Remove a Beta Squad installation from your account
/beta-review	—	Staff	Review Beta Squad applications

Community guides

Command	Options	Access	What it does
/guide-apply	—	Anyone	Apply to become a guide creator
/guide-create	—	Guide creators	Create a new guide draft in the collaborative drafts forum
/guide-ready	`notes`	Guide creators	Mark your draft as ready for staff review
/guide-admin	`action`	Staff	Publish or reject a draft guide

Community and fun

Command	Options	Access	What it does
/onboarding-progress	`user` (staff only)	Anyone	Show your onboarding quest progress
/leaderboard	`category`	Anyone	Stats across dice rolls, pings, mentions, commands used, and onboarding
/lore	`topic` — a topic, `list`, or `random`	Anyone	Discover QuickBox lore and history
/roll	`opponent`	Anyone	Roll a d20, or duel another member by tagging them

Bot diagnostics

Command	Options	Access	What it does
/ping	`host`, `verbose`, `show`, `hidden`	Anyone	Bot latency, or ping a custom host
/health	`verbose`	Anyone	Bot health and infrastructure connectivity

Staff commands

Listed for transparency. These only appear for members who hold the matching role.

Command	What it does
/verify-check	Check a member's verification status
/verify-sync	Force a recheck of all verified members
/verify-report	Verification report grouped by install type and status
/verify-ping-king	Assign the Ping King role to the current leaderboard leader
/serverstats	Total member stats for the server
/clean	Delete recent messages in a channel
/quest-cleanup	Clean up idle onboarding messages
/reset-onboarding	Reset a member's onboarding progress
/post-vault-rules	Post the vault rules and language acknowledgment menu
/export-topology	Export the server's channel topology
/cortex	Manage automatic-reply safety controls
/train-category	Add a training phrase to a forum category
/github-status	Check GitHub API usage status
/rotate-check	Check GitHub token validity
/post-commits-now	Post the latest commit to the commit feed
/docs-publish	Publish the command documentation as paginated embeds
/registry-list	List all registered commands
/registry-reload	Scan and optionally rewrite the command registry
/reload-commands	Reload slash command definitions from disk
/migrate	Run schema migrations

FAQ

Use /verify. It is a DM conversation, it needs nothing from your server, and completing it links your Discord account to your QuickBox Pro account — so /server add can offer you the installs already on your licence instead of asking for a URL and a key. Use /verify-start only if you would rather verify against the installation directly, or your licence predates the v3.quickbox.io portal. Both grant the same Verified role.

Discord hides commands you are not permitted to run. Staff commands never appear for members. Verified-only commands do appear but reply with an access-denied message until you verify.

Most replies are private to you. Setting show:true posts the reply into the channel so others can see it — useful in a support thread. Pair it with hidden:true to mask your hostname.

It obfuscates the hostname or IP in the output so the readout can be shared publicly without exposing where your server lives.

The host option is optional on most commands and resolves to your linked server automatically. It exists so members with several servers can choose.

Verification continues in a DM once you start it in the server. Other commands are run in the server so the bot can check your roles.

QBXWatcher Overview

What the bot does and how to talk to it

Verifying Your License

Unlock the verified commands

Linking & Monitoring Servers

Server commands in context

Getting Help

Support commands in context

CLI Reference

The qb commands you run on the server itself

Join the Community

Media server operators sharing configs, getting support, and shaping the future of QuickBox Pro.

Dedicated Support

Feature Previews

Community Configs

Active Discussions

Join Discord Server