Skip to main content
QuickBox Pro QBXWatcher mascot holding a wrapped gift in the snow beside a Christmas tree under holiday string lights

Got a Black Friday server? Your first hour with QuickBox Pro

Holiday pricing on new QuickBox Pro licenses runs through January 1, applied at checkout with no code. Then we walk your first hour with a fresh server, dashboard first and CLI second.

JMSolo 👑7 min read

Holiday pricing on new QuickBox Pro licenses runs through January 1, and you don't type a code to get it. If you just picked up a Black Friday VPS or dedicated box, this is also your plan for the first hour with it: install, add apps, lock them down, take a backup, and set up the people who share the server.

The holiday sale

The sale is for new purchases. It applies at checkout on its own, with no code, and the pricing page shows the holiday price with the date it ends. These are the prices for one server:

BillingRegular priceHoliday price
Yearly$79.99$52.00 for the first year (35% off), then $79.99 a year
Monthly$7.99$4.00 for the first month (50% off), then $7.99 a month
Lifetime$299$224.99, one payment (25% off)

The discount covers the first payment only. Renewals bill at the regular price, and nothing changes for licenses you already hold or for what they renew at.

There is no free trial and no refund, so the live demo is the trial. It needs no signup and has four accounts to click through: v4demo.quickbox.io. Click through it before you pay for anything.

The rest of this article doesn't depend on the sale, so it holds after January 1 too.

Check the server before you pay

QuickBox Pro installs on a fresh, minimal server, as root, on one of these:

  • Debian 12 or Debian 13
  • Ubuntu 22.04 or Ubuntu 24.04

It is x86_64 only. The packages QuickBox ships are built for x86_64, so an ARM server won't work, and it's better to know that before you buy a box. If you run the installer on any other distro it stops at its distro check and prints the list it supports. The full prerequisites are in the Getting Started guide.

Install QuickBox Pro

Copy your API key from your account's API keys page, then run the installer with it:

bash
./qbpro -u USERNAME -p 'PASSWORD' -k 'API_KEY'

-u and -p are the QuickBox username and password you'll sign in with, and -k is the key. Keep the password to letters and numbers for now. You can set a stronger one from the dashboard once you're in. Add -d 'yourdomain.com' -e 'you@example.com' and the installer turns on SSL for that domain as well.

Before it touches anything, the installer prints the API key it's about to activate and asks you to type a random confirmation number. That's your last chance to catch a pasted key from the wrong account. When it finishes, open your server's address and sign in to the dashboard with that username and password. Everything below happens there.

Add your apps from Package Management

Open the App Dashboard and switch to Package Management. Pick the app, click Install, and watch the install log stream live in the dashboard. QuickBox has 65+ apps and counting, so whether it's a torrent client, a media server or the *arr apps, it's the same few clicks. As an admin you also choose which account owns the app.

The Install button runs the same script as the CLI, so the result is identical either way:

bash
qb install sonarr -u username

What each person sees in Package Management follows their group. Admins see the whole catalog, and everyone else sees only what their group allows.

Put a login in front of every app

Every app is its own web page on your server, and QuickBox has a switch that puts a login in front of it. In the App Dashboard, expand the app's row and find Web login at the end of Service & Access. Turn it on and the app's page asks for your QuickBox username and password before it opens.

Underneath, it's nginx basic auth in the app's own nginx config, so it sits in front of the app whatever the app does itself. Turning it on needs no confirmation. Turning it off asks first, because it means anyone who can reach the address can open the app. QuickBox checks every change with nginx -t, and if nginx rejects it the earlier configuration goes back and the switch shows what's really in place. You sign in once, and every other app with the login on opens without asking again until you close the browser.

From the CLI:

bash
qb manage nginx -o enable -s sonarr -u username

The same command takes -o status and -o disable. Application Management covers the switch in full, including when a non-admin account sees it.

Take a Full Backup before you change anything

Do this once the apps are set up and again before any big change. You can start a Full Backup from two places:

  • Content > Asset Management Center > Application Backups. Expand the app, click Back up now and pick the full backup.
  • The App Dashboard. Stay on Application Control, expand the app's row (click the row, or the arrow beside the app name), and under Operations click Backup, then Full backup.

A Full Backup holds the app and its config folder, minus the transient logs. Every SQLite database in it is copied through SQLite's online-backup API, so the copy is consistent while the app is running and you don't have to stop anything. For Emby and Jellyfin it keeps the settings, plugins and the whole data folder and leaves out the huge metadata tree that the app rebuilds itself. Backups land under the owner's ~/.QuickBox/software/<app>/backup/ and you can download them from the dashboard. Your account needs the backup permission for this, which admins have.

From the CLI:

bash
qb manage software -o backup -o app -u username -s sonarr

To roll back, expand the same row, open Operations and click Restore, then pick the backup. For a full backup the button reads Rollback. It runs as a background job on the server, so closing the dialog doesn't stop it. Before restoring a database QuickBox clears the stale -wal, -shm and -journal files beside it, which are the ones that make an app refuse to start after a manual restore. Afterwards it waits for the app to answer on its port before it reports success.

bash
qb manage software -o rollback -o app -u username -s sonarr

Keep it current from the same dashboard

When an app has an update, an amber Update badge appears on its row in the App Dashboard. Click it and QuickBox runs the same update as qb update sonarr -u username. The badge only shows when the available version is newer than the one you run, so you never get offered a step backwards.

QuickBox itself updates from System > Changelog. The page is titled Updates, a pulsing Update badge sits on its sidebar entry while one is waiting, and the Update QuickBox button is on the Maintenance > Actions card. The release notes for every version you're behind are listed before you download anything, so you read what changes first. From the CLI it's:

bash
qb update quickbox

The update runs ten ordered stages and stops at the first one that fails. The new version is written only after every stage has passed, so QuickBox never records a version it didn't reach.

Set up the people who share the box

If anyone else is going to use the server, open User Management > User Admin and click Create User. Give them a username, a display name, an email, a password, a group and a storage quota. The dashboard creates the Linux account, the home directory and the system files for you. From the CLI, the password can come from stdin so it never shows up in the process list:

bash
printf '%s\n' "$PASSWORD" | qb user create -u username --password-stdin -e person@example.com

Two things decide what a person can do, and they're kept apart on purpose. User Management > User Groups decides which app categories someone can see and install. A new account starts without rTorrent or ruTorrent until its group allows them. User Management > User Roles decides admin powers, and there are 38 admin permissions to hand out. QuickBox ships four built-in roles (Super Admin, Administrator, User and Banned), and you can add your own. Administrator holds every admin permission except impersonation, so you can give someone the keys to the server without letting them act as another user.

The User Management docs go through the dialogs and the permission matrix.

Try it, then decide

If you haven't clicked through the live demo yet, do that first. When you're ready, the pricing page shows the holiday price for each billing option and the day it ends. And if you get stuck on any step above, the QuickBox Discord server at https://discord.gg/mca7RSv5pa is the only support channel, and it's where we'll see your question.

See it running before you decide

QuickBox Pro brings these tools together in one managed platform. The live demo needs no signup, so you can click through the real dashboard first.