Getting Started

Standard Server Install

Supported OS/Distro

Ubuntu 16.04 Passing Ubuntu 18.04 Passing

Before installation

You need to have a Fresh “blank” server installation. After that access your box using a SSH client, like PuTTY. Please run in root to avoid conflicts.

How to install

IMPORTANT: DO NOT use usernames such as admin or root as these are system reserved and could cause breakage on certain functionality in QuickBox Pro. Additionally, try to avoid using characters such as !, \, /, +, @, and % in passwords on setup as this can cause an identifying issue within Linux.
Run the following command to grab our latest release …
wget -q https://lab.quickbox.io/QuickBox/Pro/raw/master/qbpro && chmod +x qbpro; \
./qbpro -u='username' -p='password'
What do these values mean?
Options:
-u, --username The QuickBox primary user
-p, --password The QuickBox primary user password
-h, --help Display this help and exit
-v, --version Output version information and exit

Examples

Note that these fields are unique to your wants. -u='YOURUSERNAME' and -p='YOURPASSWORD' fields are required. ./qbpro -u='username' -p='password' 

Back To Top

Docker Install

Supported OS/Distro

Ubuntu 14.04 Passing Ubuntu 16.04 Passing Ubuntu 18.04 Passing Debian 8 Passing Debian 9 Passing

How to install

IMPORTANT: DO NOT use usernames such as admin or root as these are system reserved and could cause breakage on certain functionality in QuickBox Pro. Additionally, try to avoid using characters such as !, \, /, +, @, and % in passwords on setup as this can cause an identifying issue within Linux.

Install git

apt-get -y install git lsb-release

Grab the QuickBox Pro Docker Repo

git clone https://lab.quickbox.io/QuickBox/Pro-Docker.git quickbox; \
cd quickbox; \
cp -u /root/quickbox/qb -t /usr/bin && chmod +x /usr/bin/qb

Build your QuickBox Container

qb build quickbox USERNAME PASSWORD MOUNT

Note: Enter the MOUNT as /home, /root, or otherwise. Always starting with a forward slash

Running QuickBox Container Control

To ENTER your quickbox container
qb enter quickbox
To START your quickbox container
qb start quickbox
To STOP your quickbox container
qb stop quickbox
To RESTART your quickbox container
qb restart quickbox
To SHOW STATS for your quickbox container
qb stat quickbox
To SHOW LOGS for your quickbox container
qb log quickbox
To REBUILD your quickbox container
qb rebuild quickbox USERNAME PASSWORD MOUNT

Note: Enter the MOUNT as /home, /root, or otherwise. Always starting with a forward slash

To DESTROY your quickbox container

IMPORTANT!
Destroying your container will remove all volumes on the host machine as well

qb destroy quickbox
To CLEANUP old containers

Remove all containers the have stopped for > 24 hours
– Delete all docker images for old containers
– Delete all stopped and orphan containers

qb cleanup
To UPDATE your qb controller
qb update

Back To Top

How to install Quotas

About the Quota installer

Users can now directly edit their fstab to ensure a proper mount for quotas, this is especially great for those with mount points such as /mnt /media /somethingweird. So in short, QuickBox Pro now lifts the limitations seen in QuickBox Community when it comes to handling custom mount points.

Setting your primary mount point for Quotas

If you have installed QuickBox Pro using the setup binary as of v0.5.6, then you have entered your mount partition on the GUI setup. If this is the case, you can skip the next segment and move on to Example of editing your fstab from the Quota installer.

Finding your Primary Partition for mounting quotas

To find your primary partition is a simple task, from shell as sudo or root, run the command df. This will have an output such as the following:

# df
Filesystem     Type      Size  Used Avail Use% Mounted on
udev           devtmpfs  7.8G     0  7.8G   0% /dev
tmpfs          tmpfs     1.6G  156M  1.4G  10% /run
/dev/md2       ext4      205G   79G  117G  41% /
tmpfs          tmpfs     7.8G  8.0K  7.8G   1% /dev/shm
tmpfs          tmpfs     5.0M     0  5.0M   0% /run/lock
tmpfs          tmpfs     7.8G     0  7.8G   0% /sys/fs/cgroup
/dev/md0       ext4      464M  109M  327M  26% /boot
overlay        overlay   205G   79G  117G  41%

What you are looking for is typically the drive with the most space available. In this case, it’s the /(root) mount.

Entering your Primary Partition for mounting quotas

Now that you know your primary partition, navigate to the General Settings page and locate the field titled Disk Mount. Within this field you will enter the partition for quotas to make use of. For purposes of our demo, we will enter / for the root mount.

Next, click the Submit Changes button and proceed to install quotas from your dashboard’s Application Management Center on the Apps Dashboard.

Example of editing your fstab from the Quota installer

When installing quotas, you’ll notice there is a field entered with the specific string that needs to be added…

usrjquota=aquota.user,jqfmt=vfsv1,errors=remount-ro

…thus, if you’re using Hetzner, you may see somethin like the following:

proc /proc proc defaults 0 0
/dev/md/0 none swap sw 0 0
/dev/md/1 /boot ext3 defaults 0 0
/dev/md/2 / ext4 defaults 0 0
/dev/md/3 /home ext4 defaults 0 0

In this for instance, your primary mount point is on /root. Therefore, as per the suggested string that is posted for change, you’re updated fstab field will look like the following edit:

proc /proc proc defaults 0 0
/dev/md/0 none swap sw 0 0
/dev/md/1 /boot ext3 defaults 0 0
/dev/md/2 / ext4 usrjquota=aquota.user,jqfmt=vfsv1,errors=remount-ro 0 1
/dev/md/3 /home ext4 defaults 0 0

Video Demo

Check out how this works in the below video demonstration.

 

Back To Top