User Tools

Site Tools


Install KeexyBox

KeexyBox is a software program to be installed in Raspbian and requires a Raspberry PI box.

Hardware requirement

You will need the following in order to install KeexyBox:

  • MicroSD card >= 16GB
  • Good quality micro USB power supply > 2.5A
  • RJ45 cable
  • A Raspberry Pi Case

Install KeexyBox by flashing MicroSD


  1. Download Raspbian Lite image bundled with last KeexyBox.
  2. Use balenaEtcher to flash the downloaded .img.xz image on your MicroSD.
  3. Insert MicroSD card in your Raspberry PI.
  4. Plug a RJ45 cable between your Raspberry PI and your internet router.
  5. Plug micro USB power supply.

You are done with the installation.


KeexyBox is accessible by following IP addresses for configuration:

You may have to change the network settings of the computer you use to reach KeexyBox. For exemple, you can set the IP address on your computer, then you will be able to reach KeexyBox by this address

when you are able to reach one of KeexyBox's addresses, connect as admin, with password KeexyBox974 and then configure KeexyBox:

  1. Configure Date and time.
  2. Configure Network. (:!: It is recommended reading this article to understand KeexyBox’s network topologies).
  3. Configure DHCP.
  4. Feed the Blacklist.
  5. Create Profiles.
  6. Add Users.
  7. Declare Devices (Optional).

:!: The default credentials for SSH are the same as Raspbian default.

Install KeexyBox from installation script



Connect as root to the console of your Raspberry PI and follow the instructions below.

Download KeexyBox:

cd ~

Extract files:

tar xzf keexybox_20.04.4_raspbian10.tar.gz

Run installation:

cd keexybox_20.04.4_raspbian10

Set the KeexyBox Admin password (the password must contains at least 8 chars):

Confirm the KeexyBox Admin password:

Select Yes to confirm the installation:

When KeexyBox is successfully installed you should have the screen below:

Note the KeexyBox Web interface addresses and select OK. The next step is the post installation.

Post installation

For the post installation, you need to use an Internet Browser and enter the given KeexyBox Web interface address, example:


:!: You will get a security alert if you connect to it using HTTPS. This is because KeexyBox uses a self-signed certificate. You must override the alert to connect to it.

Wherever you are on the KeexyBox Web interface, you can change the language by clicking on the flag at the top right, then select your language.

By default when you access the KeexyBox’s web interface, you are redirected to the captive portal allowing users to connect to the Internet. You have to switch to the KeexyBox administration by clicking on Admin and then click on Manage.

You must connect with the admin account and the password defined during the installation.

You are now on the KeexyBox’s configuration wizard page.

You have to choose first, how you want to use KeexyBox. To make the best choice for your needs, it is better to understand the KeexyBox’s network topologies. Depending of your choice, the wizard will be different.

For the next steps everything is explained on the wizard.

  1. Accept the licences.
  2. Date and time settings: Refer to KeexyBox - Date and time if you need more help.
  3. Network settings: Refer to KeexyBox - Network settings if you need more help.
  4. DHCP settings (you can skip this step): Refer to KeexyBox - DHCP settings if you need more help.
  5. Add domains to the Blacklist (you can skip this step): Refer to KeexyBox - Manage the Blacklist if you need more help.
  6. Add a new user (you can skip this step): Refer to KeexyBox - Manage users if you need more help.
  7. Scan and add devices (you can skip this step): Refer to KeexyBox - Manage devices if you need more help.
  8. For the last step, click on Finish to reboot you KeexyBox’s device.

About KeexyBox Project:

installation_installing_20.04.txt · Last modified: 2020/09/21 14:46 (external edit)