Skip to content

1. Installing

Mehran Ahadi edited this page Dec 30, 2015 · 3 revisions

LoadBox needs aria2 to run. You can install it in Debian-based distros by issuing:

$ sudo apt-get install aria2

Note: Some features like rpc_secret cannot be used on Debian/Raspbian Wheezy because of outdated aria2 package version 1.15.1-1. Please upgrade to Jessie or use a updated version.

Its dependent on Bash and Python2.7 too, if these are even count. Although it might be important if you are not using any distros and building kernel and filesystem from scratch.

Getting the sources

Clone the repo to a directory like ~/LoadBox/:

$ git clone
$ cd LoadBox
$ git submodule init
$ git submodule update
$ git submodule foreach git checkout .

It contains two submodules: SecurePyServer and webui-aria2.

There are four configuration files:

  • Shell scripts configuration:
  • Aria2 configuration: configuration.conf
  • Python scripts configuration: scripts/
  • And Web UI configuration: webui/configuration.js

Some of these files are not existing and you can create them by copying template files named in the form of sample-[filename]. The script creates default ones on first run.

Note: If you are not running on Raspbian, you should change ARIA2C_WORKING_USER and HTTP_WORKING_USER options in shell scripts configuration file.

Adding to Startup

Its recommended to disable direct booting to GUI. It will save your CPU/RAM and let you access console log output. You can use raspi-config in Raspberry Pi to change this option.

The easiest way is adding this line at the end of /etc/rc.local file. With the assumption of cloning in /home/[username]/LoadBox:


If you are using Raspberry Pi, you might want to disable screen sleep for watching console log for debugging purposes. Adding this line will prevent display blackout:

setterm -blank 0
You can’t perform that action at this time.