QuickBox README.md



Join us on our Chat Server at chat.quickbox.io !!!

To make use of the GitHub repo (all future updates posted here!)

This step is only required for users who are coming off of our self-hosted GitLab repositories. If you are installing from fresh, please see How to install


login to your server via ssh. Gain root access with sudo su followed up with cd to place you in your /root directory. Once in your /root directory, type the following to remove your current local QuickBox respositories.

rm -rf ~/QuickBox

If you are already located on the GitHub repo as of v2.4.9, run the following to easily update to the new v2.5.+ QuickBox/QB repo:

rm -rf /etc/QuickBox; \
git clone https://github.com/QuickBox/QB /etc/QuickBox; \
wget -O /usr/local/bin/quickbox/system/updateQuickBox https://raw.githubusercontent.com/QuickBox/QB/master/packages/system/updateQuickBox; \
dos2unix $(find /usr/local/bin/quickbox -type f) && chmod +x $(find /usr/local/bin/quickbox -type f); \

If you have received the following error:

find: ‘/home/*/.config/deluge’: No such file or directory
This simply means you do not have Deluge installed, there is no further action for you take.

The continuation below explains the above all-in-one code, minus the removal of the recent locations at /root/QuickBox


grab the current/future QuickBox repository with the following:

git clone https://github.com/QuickBox/QB /etc/QuickBox

If you receive an error /etc/QuickBox already exists please perform an rm -rf /etc/QuickBox. You can then run the git clone command above to proceed.


update your current update function by doing the following:

rm -rf /usr/local/bin/quickbox
cp -r ${local_packages}/. /usr/local/bin/quickbox
dos2unix $(find /usr/local/bin/quickbox -type f)
chmod +x $(find /usr/local/bin/quickbox -type f)
cp -f /usr/local/bin/quickbox/system/reload /usr/bin/reload


run the upgrade script to match any recent changes and to get you on your way:


Script status

Version 2.5.1-beta GNU v3.0 License

Ubuntu Builds

Ubuntu 15.10 Passing Ubuntu 16.04 Passing Ubuntu 16.10 Failing

Debian Builds – SUPPORT DISCONTINUED [USE Ubuntu 16.04]

Debian 8 Null

Quick Advisory Notice(s) on QuickBox


grsec is built into OVH’s custom kernel and it absolutely wrecks havoc when using these panels where we depend on the ability for one user (www-data) to see the processes of another running user ($username).

This can be seen clearly by using a task manager such as h/top.

With grsec enabled you can only see the processes owned by your user unless you run htop as root. As such, it is highly recommended to use the stock kernel for your distribution or at the very least installing an OVH kernel that is not compiled with grsec

If you are using So You Start (SYS) as a host, you should opt to use the distribution kernel. You will see this as a checkbox option when installing your server. Otherwise, QuickBox will handle this for you on install.

Please understand that we do not want to push this project as a means to supply a commercially used product, ie; seedbox provider - so keep this in mind - only if you wish to sale slots on your server. Though it is very multi-user friendly… it is also not free of it’s faults due to it’s high amount of capabilities and being publicly available. This is a community based project that is a measure of goodwill to be given to such an outspoken and freethinking community.

A Preview of Quick Box

This script has the following features

  • A multi-user environment, complete with scripts to add and delete users.
  • Linux Quota, to control how much space every user can use in the box. This can be controlled via the ‘setdisk’ command.
  • Customized Seedbox Dashboard located at https://SERVER_IP/
  • HTTPs Downloads directory (https://SERVER_IP/${username}.downloads)
  • Obscures ports for ssh and ftp. SSH = 4747 | FTP = 5757 (note, this is not for security reasons… it’s simply a means to reduce bad bot hits from all over the web)
  • Creates a limited shell access environment. This gives your additional created users the ability to interact with their seedbox via ssh on port 4747 w/o having access to other users shells and/or root/sudo commands and functions.

Installed software

  • Linux Quota
  • LShell - (LimitedShell for additional users to ssh)
  • SSH Server (for SSH terminal and sFTP connections)
  • pureftp - vsftp (CuteFTP multi-segmented download friendly)
  • HTTPS - Web Console
  • ruTorrent 3.7 + official plugins
  • rTorrent 0.9.6
  • libTorrrent 0.13.6
  • mktorrent
  • Deluge (Web-client and thin-client)
  • BTSync
  • CouchPotato
  • ConfigServer Firewall
  • Emby
  • Jackett
  • NextCloud
  • OpenVPN
  • Plex
  • PlexPy
  • Plex Requests (.NET)
  • pyLoad
  • Quassel
  • Quotas
  • Radarr
  • Rapidleech
  • SABnzbd
  • SickRage
  • Sonarr
  • Subsonic
  • Syncthing
  • X2Go - Remote Desktop
  • ZNC
  • … more to come (or how about that feature request?)

Main ruTorrent plugins

autotools, cpuload, quotaspace, erasedata, extratio, extsearch, feeds, filedrop, filemanager, geoip, history, logoff, mediainfo, mediastream, ratiocolor, rss, scheduler, screenshots, theme, trafic and unpack

Additional ruTorrent plugins

  • Autodl-IRSSI (with an updated list of trackers)
  • A modified version of Diskpace to support quota (by Notos)
  • Filemanager (modified to handle rar, zip, unzip, tar and bzip)
  • Fileshare Plugin (http://forums.rutorrent.org/index.php?topic=705.0)
  • Logoff
  • Theme: QuickBox Dark rutorrent skin
  • Colorful Ratios: Customized to match QuickBox Theme
  • rutorrentMobile: Mobile version of ruTorrent - seriously - toss TransDroid and the pain that it is… this is a new essential plugin (IMO)

Before installation

You need to have a Fresh “blank” server installation.
After that access your box using a SSH client, like PuTTY.

How to install

You must be logged in as root to run this installation.

Ubuntu 15.10, 16.04 & 16.10

Run the following command to grab our latest stable release …

apt-get -yqq update; apt-get -yqq upgrade; apt-get -yqq install git lsb-release; \
git clone https://github.com/QuickBox/QB /etc/QuickBox &&
bash /etc/QuickBox/setup/quickbox-setup

Want to run in development mode?

Run the following command to grab current development repos …

mkdir /install/ && touch /install/.developer.lock; \
apt-get -yqq update; apt-get -yqq upgrade; apt-get -yqq install git lsb-release; \
git clone --branch "development" https://github.com/QuickBox/QB /etc/QuickBox &&
bash /etc/QuickBox/setup/quickbox-setup

Already have QuickBox installed and want to switch over to development?

EASY! Run the following command to grab current development repos …

mkdir /install/ && touch /install/.developer.lock; \
sudo box upgrade


After installing you will have access to the following commands to be used directly in terminal

  • createSeedboxUser - creates a shelled seedbox user
  • deleteSeedboxUser - deletes a created seedbox user and their directories
    This is permanent, current data will be deleted - you can create them again at any time
  • changeUserpass - change users SSH/FTP/deluge/ruTorrent password
  • setdisk - set your disk quota for any given user
  • showspace - shows amount of space used by each user
  • reload - restarts your seedbox services, i.e; rtorrent & irssi
  • upgradeBTSync - upgrades btsync when new version is available
  • upgradePlex - upgrades Plex when new version is available
  • removepackage-cron - upgrades your system to make use of systemd
    + (must be on Ubuntu 15.10+ or Debian 8)
  • clean_mem - flushes servers physical memory cache (helps avoid swap overflow)

Fresh install on Debian - No Disk Status and Can No longer use SSH
No disks status
Custom hostname issue + a few other issues
Quota problems after initial setup
ruTorrent problems
Plex not working after upgrade
Bandwidth Data plugin issue
Missing Sonarr Link in Dashboard + All "Red" in Service Control Center
Best Way to update scripts 2.1.1 to 2.20
Badge service disable / Menu disable