QuickBox Pro v3 Command Line Interface

Article Contents

Command Line Interface

Despite having an easy to use dashboard, some users prefer using terminal to execute certain commands! We’ve compiled a list of all QuickBox commands to make life a little bit easier.

Autocomplete

Simply start typing a command and hit tab you’ll be presented with a list of valid qb commands, if there is only a single possible command following your input, tab will complete your current input to that. Be aware that autocomplete will not finalize some of the more intricate optional parameters. so it’s vital to consult the help pages and functions as needed.

It is important that you elevate your permissions first of all. In order for these commands to work on QuickBox Pro, you must do sudo -i followed by hitting enter on your keyboard first, then type in your command.

API Commands:

Manage API Key:

qb manage api
  • Manage QuickBox API keys and list additional information and options.

Activate API Key:

qb manage api -k [KEY]
  • This command will activate a valid Pro Subscription on your server. If no API Key is specified you’ll be prompted to enter one.

Deactivate API Key:

qb manage api -o deactivate
  • This command will deactivate the current API Key activation on the server.

Clean Commands:

Clean Memory:

qb clean memory
  • This command will attempt to clear system memory caches and free up available memory.

Clean Dashboard Logs:

qb clean dashboard_logs -u [USERNAME]
  • This command will attempt to clean the QuickBox dashboard logs for the designated user.

Clean Rclone Upload Logs:

qb clean rclone_logs -u [USERNAME]
  • This command will attempt to clean the QuickBox rclone upload logs for the designated user.

Clean Apt/Dpkg Locks:

qb clean lock
  • This command will attempt to resolve any dpkg locks. These issues are normally caused by interrupting apt upgrades, lacking certain dependencies, or simply from the time on your server being incorrect.

Dashboard Commands:

Set Preferred Dashboard Domain:

qb manage webroot -o [server_ip (or) domain]
  • This command sets the server web root for dashboard access.
  • Example:
  • qb manage webroot -o yourdomain.com (OR)
    qb manage webroot -o server_ip
    Will set the access to your dashboard to either the expressed Domain or IP Address.

Fix Commands:

Fix /home Permissions:

qb fix home -u [USERNAME]
  • This command will attempt to fix the designated users home directory permissions.

Fix Php:

qb fix php
  • This command will attempt to fix issues with the PHP installation. These issues happen when the updates are applied incorrectly or the updater is interrupted.

Fix Python:

qb fix python
  • This command will attempt to recompile the Python installation to v3.9.2 on supported Distro. Recompiling may be needed when certain dependencies are required/updated and python3.9 needs to be rebuilt.

Fix Version (or) Version Reset:

qb fix version
  • This command will attempt to reset the current version installed. If a newer version is found, it will update accordingly.

Help Commands:

QB Help Manual:

qb -h || qb --help || man qb
  • Any one of the above commands will display the qb help manual. Essentially, what you see here.

Software Command Help:

qb help [SOFTWARE]
  • This command will show a list of options and process commands for the designated software.
  • Example:
    ❯ qb help sonarr
    
    * Usage: qb [install|reinstall|remove|update] sonarr -u [user] -o [nightly|4k]
    
    ------------------------------------------------------- ------------------------------------------------------------
    EXAMPLES                                                NOTES
    ------------------------------------------------------- ------------------------------------------------------------
    qb install sonarr -u user                               installs latest stable version of sonarr for user      
    qb install sonarr -u user -o nightly                    installs latest nightly version of sonarr for user     
    qb install sonarr -u user -o 4k                         installs latest stable version of sonarr4k for user    
    qb install sonarr -u user -o 4k -o nightly              installs latest nightly version of sonarr4k for user   
    qb reinstall sonarr -u user                             reinstalls latest stable version of sonarr for user    
    qb reinstall sonarr -u user -o nightly                  reinstalls latest nightly version of sonarr for user   
    qb reinstall sonarr -u user -o 4k                       reinstalls latest stable version of sonarr4k for user  
    qb reinstall sonarr -u user -o 4k -o nightly            reinstalls latest nightly version of sonarr4k for user 
    qb remove sonarr -u user                                removes sonarr for user                                
    qb remove sonarr -u user -o 4k                          removes sonarr4k for user                              
    qb update sonarr -u user                                updates sonarr to latest stable version for user       
    qb update sonarr -u user -o nightly                     updates sonarr to latest nightly version for user      
    qb update sonarr -u user -o 4k                          updates sonarr4k to latest stable version for user     
    qb update sonarr -u user -o 4k -o nightly               updates sonarr4k to latest nightly version for user    
    ------------------------------------------------------- ------------------------------------------------------------

Want added verbosity to your software commands? Just add the -v flag to the end of your arguments.

Language Commands:

Select Preferred Server Language:

qb manage lang -o [de|german | dk|danish | en|english | es|spanish | fr|french | pt|portuguese | zh-cn|chinese]
  • This command will set the requested language as the default language for the server.
  • Example:
  • qb manage lang -o en (OR) qb manage lang -o english will set the servers default to English.

Software Commands:

Install Software:

qb install [SOFTWARE] -u [USERNAME] -o [OPTION1] -o [OPTION2]
  • This will install the software specified for the designated user account.

Remove Software:

qb remove [SOFTWARE] -u [USERNAME] -o [OPTION]
  • This will remove the software specified from the designated user account.

Update Software:

qb update [SOFTWARE] -u [USERNAME] -o [OPTION]
  • Use qb update tab to get a list of updatable software as well as any options (ie; versions such as with Sonarr)

Reinstall Software:

qb reinstall [SOFTWARE] -u [USERNAME] -o [OPTION1] -o [OPTION2]
  • This will reinstall the software specified for the designated user account.

It's important to be sure to use the proper remove/update commands for software such as Radarr and Sonarr. These two applications provide separate 4K builds within the same package. Therefore, if wanting to remove Radarr 4K and keep Radarr, ensure the -o 4k flag is set to remove Radarr 4K only.


Use qb help [SOFTWARE] when unsure!

Support Commands:

Enable quickSupport:

qb support enable
  • This command will enable the support account for QuickBox Pro Support Staff to connect.

Disable quickSupport:

qb support disable
  • This command will disable the support account.

To ensure the security of your account, quickSupport is created with a signed set of security keys that are rotated weekly. This ensures that only verified Support Staff holding the secure keys can access the activated account on your server.


The support account will be automatically deactivated and deleted after a 24 hour period.

Tracker Commands:

Enable Public Trackers:

qb manage trackers -o enable
  • This command will allow the ability to connect to public trackers.

Disable Public Trackers:

qb manage trackers -o disable
  • This command will block the ability to connect to public trackers.

Disabling public trackers creates rules in the /etc/hosts file, as well as iptables.


A daily cron task is created to ensure that any additional ips are updated on the tables. This job file can be found at:
/etc/cron.daily/deny_public.


The list of denied hosts can be adjusted to meet your needs. This file can be found at:
/opt/quickbox/config/system/trackers/tracker_list

Update Commands:

Check for Update:

qb update check
  • This command will check for any available QuickBox updates.
    If you have automatic updates enabled, it will update your server as well.

Update QuickBox Install:

qb update quickbox
  • This command will update QuickBox Pro if a new version is available.

QuickBox performs update checks every hour, on the hour.
This is set by way of a cron job located at:
/etc/cron.d/quickbox

User Commands:

Create User:

qb user create -u [USERNAME] -p [PASSWORD] -e [EMAIL]
  • This command will create the specified QuickBox user.
  • The following example creates a user named echo with the password quickbox and the email [email protected]: qb user create -u echo -p 'quickbox' -e '[email protected]'
  • A friendly word of caution. Try to avoid using usernames that are too similar, as this can cause unexpected side-effects across various commands and functions. Example: user and users, paul and pauly etc. etc. In short, be creative!

Delete User:

qb user delete -u [USERNAME]
  • This command will delete the specified QuickBox user.

Change User Password:

qb user password -u [USERNAME] -p [NEWPASSWORD]
  • This command will update the specified QuickBox user’s password.

Set User Quota:

qb user quota -u [USERNAME] -o [SIZE(GB|TB)]
  • This command will set a quota limit for the specified user.

Show User Quota:

qb user show -u [USERNAME]
  • This command will show the quota limit for the specified user.

Ban User:

qb user ban -u [USERNAME]
  • This command will ban the specified QuickBox user.

Unban User:

qb user unban -u [USERNAME]
  • This command will unban the specified QuickBox user.

Promote User to Admin:

qb user promote -u [USERNAME]
  • This command will promote the specified user to admin.

Demote User from Admin:

qb user demote -u [USERNAME]
  • This command will demote the specified user from admin to a standard registered user.

Set User Shell:

qb user shell -u [USERNAME] -o [full|limited|sudo]
  • This command will set the specified users bash environment.
    • limited = This is the default user shell, known as Limited Shell. Limited shell, limited commands.
    • full = Full permissions to browse server, minus sudo and limited on file editing.
    • sudo = sudo privileges to the server, can do all the things. “With great power comes great responsibility.” ~ The Peter Parker principle

User Rclone Companion Commands:

qb user rclone -u [USERNAME] -o [remove_lock|upload|logs]
  • -o remove_lock = This command removes the lock file placed by the rclone move.sh script. This is useful in the event the previous upload attempt stalled, failed, or was somehow interrupted. Should the lock remain in place, media will fail to be moved at the set schedule.
  • -o upload = This command will force the upload for rclone to gdrive. Otherwise, media will be moved nightly on schedule at 03:00.
  • -o logs = This command will show a summary of the last results of the rclone move log. The full log can be viewed at /home/[USERNAME]/rclone/move.log.
Related Articles
Need Support?
Can’t find the answer you’re looking for? Don’t worry we’re here to help!
Contact Support
The following terms and conditions govern all use of the QuickBox.io website and all content, services and products available at or through the website, including, but not limited to, QuickBox.io Forum Software and the QuickBox.io Support Forums, (taken together, the Website). The Website is owned and operated by (“QuickBox.IO”). The Website is offered subject to your acceptance without modification of all of the terms and conditions contained herein and all other operating rules, policies (including, without limitation, QuickBox.io’s Privacy Policy and Community Guidelines) and procedures that may be published from time to time on this Site by QuickBox (collectively, the “Agreement”). Please read this Agreement carefully before accessing or using the Website. By accessing or using any part of the web site, you agree to become bound by the terms and conditions of this agreement. If you do not agree to all the terms and conditions of this agreement, then you may not access the Website or use any services. If these terms and conditions are considered an offer by QuickBox, acceptance is expressly limited to these terms. The Website is available only to individuals who are at least 13 years old.

Your QuickBox.io Account

If you create an account on the Website, you are responsible for maintaining the security of your account and you are fully responsible for all activities that occur under the account. You must immediately notify QuickBox of any unauthorized uses of your account or any other breaches of security. QuickBox will not be liable for any acts or omissions by you, including any damages of any kind incurred as a result of such acts or omissions.

Responsibility of Contributors

If you post material to the Website, post links on the Website, or otherwise make (or allow any third party to make) material available by means of the Website (any such material, “Content”), You are entirely responsible for the content of, and any harm resulting from, that Content. That is the case regardless of whether the Content in question constitutes text, graphics, an audio file, or computer software. By making Content available, you represent and warrant that:
  • the downloading, copying and use of the Content will not infringe the proprietary rights, including but not limited to the copyright, patent, trademark or trade secret rights, of any third party;
  • if your employer has rights to intellectual property you create, you have either (i) received permission from your employer to post or make available the Content, including but not limited to any software, or (ii) secured from your employer a waiver as to all rights in or to the Content;
  • you have fully complied with any third-party licenses relating to the Content, and have done all things necessary to successfully pass through to end users any required terms;
  • the Content does not contain or install any viruses, worms, malware, Trojan horses or other harmful or destructive content;
  • the Content is not spam, is not machine- or randomly-generated, and does not contain unethical or unwanted commercial content designed to drive traffic to third party sites or boost the search engine rankings of third party sites, or to further unlawful acts (such as phishing) or mislead recipients as to the source of the material (such as spoofing);
  • the Content is not pornographic, does not contain threats or incite violence, and does not violate the privacy or publicity rights of any third party;
  • your content is not getting advertised via unwanted electronic messages such as spam links on newsgroups, email lists, blogs and web sites, and similar unsolicited promotional methods;
  • your content is not named in a manner that misleads your readers into thinking that you are another person or company; and
  • you have, in the case of Content that includes computer code, accurately categorized and/or described the type, nature, uses and effects of the materials, whether requested to do so by QuickBox or otherwise.

User Content License

User contributions are licensed under a GNU General Public License. Without limiting any of those representations or warranties, QuickBox has the right (though not the obligation) to, in QuickBox’s sole discretion (i) refuse or remove any content that, in QuickBox’s reasonable opinion, violates any QuickBox policy or is in any way harmful or objectionable, or (ii) terminate or deny access to and use of the Website to any individual or entity for any reason, in QuickBox’s sole discretion. QuickBox will have no obligation to provide a refund of any amounts previously paid.

Payment and Renewal

General Terms

Optional paid services or upgrades may be available on the Website. When utilizing an optional paid service or upgrade, you agree to pay QuickBox the one-time, monthly or annual subscription fees indicated. Payments will be charged on a pre-pay basis on the day you purchase the service or upgrade and will cover the use of that service or upgrade for a monthly or annual subscription period as indicated. These fees are not refundable. The one exception is QuickBox Pro, which provides a 3 Day money back policy, after 3 days, fees are not refundable.

Automatic Renewal

Unless you notify QuickBox before the end of the applicable subscription period that you want to cancel a service or upgrade, your subscription will automatically renew and you authorize us to collect the then-applicable annual or monthly subscription fee (as well as any taxes) using any credit card or other payment mechanism we have on record for you. Subscriptions can be canceled at any time. Please be advised that renewal fees are non-refundable. We provide courtesy emails notifying you of any upcoming renewals several days in advance, failure to cancel an unwanted subscription is not the responsibility of QuickBox.IO.

Refunds

We provide a 3-day “no questions asked” refund for new QuickBox Pro subscriptions (meaning, not for QuickBox.IO provided services such as Migration Service, Server Optimization, and our Guru Install Service). Refunds do not apply for upgrades or renewals. Such refund shall be available for a period of three (3) days from the end of the business day the purchase was made (and if such day is not a business day, then the following business day). We may refuse to refund people who acted in bad faith or misused the Services, or otherwise violated any of the policies stated in the Terms of Service.

Services

Hosting, Support Services

Optional Hosting and Support services may be provided by QuickBox under the terms and conditions for each such service. By signing up for a Hosting/Support or Support services account, you agree to abide by such terms and conditions.

Responsibility of Website Visitors

QuickBox has not reviewed, and cannot review, all of the material, including computer software, posted to the Website, and cannot therefore be responsible for that material’s content, use or effects. By operating the Website, QuickBox does not represent or imply that it endorses the material there posted, or that it believes such material to be accurate, useful or non-harmful. You are responsible for taking precautions as necessary to protect yourself and your computer systems from viruses, worms, Trojan horses, and other harmful or destructive content. The Website may contain content that is offensive, indecent, or otherwise objectionable, as well as content containing technical inaccuracies, typographical mistakes, and other errors. The Website may also contain material that violates the privacy or publicity rights, or infringes the intellectual property and other proprietary rights, of third parties, or the downloading, copying or use of which is subject to additional terms and conditions, stated or unstated. QuickBox disclaims any responsibility for any harm resulting from the use by visitors of the Website, or from any downloading by those visitors of content there posted.

Content Posted on Other Websites

We have not reviewed, and cannot review, all of the material, including computer software, made available through the websites and web pages to which QuickBox.io links, and that link to QuickBox.io. QuickBox does not have any control over those non-QuickBox.io websites and web pages, and is not responsible for their contents or their use. By linking to a non-QuickBox.io website or web page, QuickBox does not represent or imply that it endorses such website or web page. You are responsible for taking precautions as necessary to protect yourself and your computer systems from viruses, worms, Trojan horses, and other harmful or destructive content. QuickBox disclaims any responsibility for any harm resulting from your use of non-QuickBox.io websites and web pages.

Copyright Infringement and DMCA Policy

As QuickBox asks others to respect its intellectual property rights, it respects the intellectual property rights of others. If you believe that material located on or linked to by QuickBox.io violates your copyright, and if this website resides in the USA, you are encouraged to notify QuickBox in accordance with QuickBox’s Digital Millennium Copyright Act (“DMCA”) Policy. QuickBox will respond to all such notices, including as required or appropriate by removing the infringing material or disabling all links to the infringing material. QuickBox will terminate a visitor’s access to and use of the Website if, under appropriate circumstances, the visitor is determined to be a repeat infringer of the copyrights or other intellectual property rights of QuickBox or others. In the case of such termination, QuickBox will have no obligation to provide a refund of any amounts previously paid to QuickBox.

Intellectual Property

This Agreement does not transfer from QuickBox to you any QuickBox or third party intellectual property, and all right, title and interest in and to such property will remain (as between the parties) solely with QuickBox. QuickBox, QuickBox.io, the QuickBox.io logo, and all other trademarks, service marks, graphics and logos used in connection with QuickBox.io, or the Website are trademarks or registered trademarks of QuickBox or QuickBoxs licensors. Other trademarks, service marks, graphics and logos used in connection with the Website may be the trademarks of other third parties. Your use of the Website grants you no right or license to reproduce or otherwise use any QuickBox or third-party trademarks.

Advertisements

QuickBox reserves the right to display advertisements on your content unless you have purchased a Services account and/or received proper access promotions within the provided Forums.

Attribution

QuickBox reserves the right to display attribution links such as ‘Powered by QuickBox.io,’ theme author, and font attribution in your content footer or toolbar. Footer credits and the QuickBox.io toolbar may not be removed regardless of upgrades purchased.

Changes

QuickBox reserves the right, at its sole discretion, to modify or replace any part of this Agreement. It is your responsibility to check this Agreement periodically for changes. Your continued use of or access to the Website following the posting of any changes to this Agreement constitutes acceptance of those changes. QuickBox may also, in the future, offer new services and/or features through the Website (including, the release of new tools and resources). Such new features and/or services shall be subject to the terms and conditions of this Agreement.

Termination

QuickBox may terminate your access to all or any part of the Website at any time, with or without cause, with or without notice, effective immediately. If you wish to terminate this Agreement or your QuickBox.io account (if you have one), you may simply discontinue using the Website. All provisions of this Agreement which by their nature should survive termination shall survive termination, including, without limitation, ownership provisions, warranty disclaimers, indemnity and limitations of liability.

Disclaimer of Warranties

The Website is provided “as is”. QuickBox and its suppliers and licensors hereby disclaim all warranties of any kind, express or implied, including, without limitation, the warranties of merchantability, fitness for a particular purpose and non-infringement. Neither QuickBox nor its suppliers and licensors, makes any warranty that the Website will be error free or that access thereto will be continuous or uninterrupted. If you’re actually reading this, here’s a treat. You understand that you download from, or otherwise obtain content or services through, the Website at your own discretion and risk.

Disclaimer of Software

This script is intended for general use and no warranty is implied for suitability to any given task. QuickBox.IO will hold no responsibility for your setup or any damage done while using/installing/modifying this script or any of its plugins. Please keep in mind QuickBox.IO nor it’s staff are responsible for keeping your Software and/or Server up-to-date; this is a responsibility solely left to the user of the QuickBox Pro software.

QuickBox.IO and it’s associated staff reserve the right to terminate support at any time on the grounds that third-party applications; not yet approved, tested, or otherwise are found to be a result in QuickBox Pro malfunctioning.

Licensed under BSD 3-Clause

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  • Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
  • Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
  • Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Limitation of Liability

In no event will QuickBox, or its suppliers or licensors, be liable with respect to any subject matter of this agreement under any contract, negligence, strict liability or other legal or equitable theory for: (i) any special, incidental or consequential damages; (ii) the cost of procurement for substitute products or services; (iii) for interruption of use or loss or corruption of data; or (iv) for any amounts that exceed the fees paid by you to QuickBox under this agreement during the twelve (12) month period prior to the cause of action. QuickBox shall have no liability for any failure or delay due to matters beyond their reasonable control. The foregoing shall not apply to the extent prohibited by applicable law.

General Representation and Warranty

You represent and warrant that (i) your use of the Website will be in strict accordance with the QuickBox Privacy PolicyCommunity Guidelines, with this Agreement and with all applicable laws and regulations (including without limitation any local laws or regulations in your country, state, city, or other governmental area, regarding online conduct and acceptable content, and including all applicable laws regarding the transmission of technical data exported from the country in which this website resides or the country in which you reside) and (ii) your use of the Website will not infringe or misappropriate the intellectual property rights of any third party.

Indemnification

You agree to indemnify and hold harmless QuickBox, its contractors, and its licensors, and their respective directors, officers, employees and agents from and against any and all claims and expenses, including attorneys’ fees, arising out of your use of the Website, including but not limited to your violation of this Agreement.

Miscellaneous

This Agreement constitutes the entire agreement between QuickBox and you concerning the subject matter hereof, and they may only be modified by a written amendment signed by an authorized executive of QuickBox, or by the posting by QuickBox of a revised version. Except to the extent applicable law, if any, provides otherwise, this Agreement, any access to or use of the Website will be governed by the laws of the state of California, U.S.A., excluding its conflict of law provisions, and the proper venue for any disputes arising out of or relating to any of the same will be the state and federal courts located in San Francisco County, California. Except for claims for injunctive or equitable relief or claims regarding intellectual property rights (which may be brought in any competent court without the posting of a bond), any dispute arising under this Agreement shall be finally settled in accordance with the Comprehensive Arbitration Rules of the Judicial Arbitration and Mediation Service, Inc. (“JAMS”) by three arbitrators appointed in accordance with such Rules. The arbitration shall take place in San Francisco, California, in the English language and the arbitral decision may be enforced in any court. The prevailing party in any action or proceeding to enforce this Agreement shall be entitled to costs and attorneys’ fees. If any part of this Agreement is held invalid or unenforceable, that part will be construed to reflect the parties’ original intent, and the remaining portions will remain in full force and effect. A waiver by either party of any term or condition of this Agreement or any breach thereof, in any one instance, will not waive such term or condition or any subsequent breach thereof. You may assign your rights under this Agreement to any party that consents to, and agrees to be bound by, its terms and conditions; QuickBox may assign its rights under this Agreement without condition. This Agreement will be binding upon and will inure to the benefit of the parties, their successors and permitted assigns.

This document was last updated January 18, 2020.

Guidelines

Please add bugs found in QuickBox Pro using this template:

Bug Report
Select Bug Report as the issue template

Please add feature requests for application inclusion in QuickBox Pro using this template:

Application Feature Request
Select Application Feature Request as the issue template

Please add feature requests for general QuickBox Pro using this template:

Select General Feature Request as the issue template
Select General Feature Request as the issue template

Viewing issues as well as feature requests does not require an account.

You will need to create an account on our Lab in order to post both Issues as well as Feature Requests.
You can register an account here if you do not already have one.

We look forward to your reports as well as your ideas and suggestions for ongoing developments to the QuickBox Pro software!

The QuickBox Pro Community Appreciation Day Event Sale is in full effect.
Get your savings on!
00
Days
00
Hours
00
Minutes
00
Seconds