Table of Contents
KeexyBox - Manage devices
For KeexyBox, a device is a hardware that can have a connectivity to the Internet. It can be a PC, smartphone, tablet, IP Camera, Smart TV or a voice assistant.
Since version 21.04.1, you can avoid registering your devices in KeexyBox to connect them to the internet. You just need to set Internet access conditions
to None
in the captive portal settings.
To manage devices:
- Use your browser and connect to the KeexyBox Management Web interface.
- On left menu, go to
Connection settings → Devices
. - You will be redirected to the
Devices
page.
Declare devices of your network to KeexyBox
You will need to declare your devices in the following cases :
- Your devices does not allow you to enter a login and password in a browser to connect it to the Internet (IP camera, TV, voice assistant…).
- You don't want to bother entering a login and password on the captive portal to connect your PCs or smartphones to the Internet.
- You want to set a DHCP IP address reservation for your device.
- If the captive portal is disable (
Internet access conditions
set toNone
in the captive portal settings) and the device must use a profile other than the one defined by default for the whole network.
There are 2 ways to declare devices to KeexyBox:
- Manually.
- By scanning your network.
Add devices manually
- Click on at the top of
Devices
page. - Click
Save
.
Add devices by scanning your network
It an easier and faster method than the manual to declare your devices. Before, you must ensure that all the devices to be declared are powered on and connected to the same physical network as KeexyBox. Then follow this steps to add your devices:
- Click on at the top of
Devices
page (This may take time depending on the size of your network). - You will get a list of devices found on your network.
- The device brand
Name
and theIP address
can help you recognize your devices. - Check boxes to the left of
IP address
(If you are not able to check the box, that means the device is already declared to KeexyBox). - At the bottom of the page, in the selection menu
(select profile)
, select the profile you want to set for devices. - Click on
Add devices
to confirm the action.
The devices will be automatically named using the brand name and part of the MAC address. You can change the name of the devices at anytime by modifying the device.
Declaring devices will not connect them to the Internet.
Connect a device to the Internet
Follow the instructions described on this topic to connect one or more devices to the Internet.
Modify a device
- On the
Devices
page, identify in the list the device you wish to modify. - Click on
Edit
button. - Click
Save
.
Edit a device
Field | Description |
---|---|
Name | The device name. |
MAC address | It is an unique identifier assigned to a network device. This address is used by KeexyBox to recognize the device on the network. Most of time it is written down directly on the device. |
Profile | Select the connection profile. |
Language | Select the language displayed on KeexyBox Web interface for the user who use the device. |
DHCP reservation IP address (optional) | If DHCP is enabled on your KeexyBox, you can reserve an IP address for it in one of the KeexyBox networks. |
Enable | Check to allow connection of the device to the Internet. |
Delete a device
- On the
Devices
page, identify in the list the device you wish to delete. - Click on
delete
button. - You will get a message asking you to confirm the deletion. Answer
yes
.
Connected device will be disconnected and next be deleted.
Export/Import devices
KeexyBox allows you to export or import devices from CSV files. Exporting or Importing devices can be useful in the following cases:
- To backup the list of KeexyBox devices.
- To massively declare devices.
- To do massive modifications on devices.
- To import devices to another KeexyBox.
Export devices to CSV file
- Click on at the top of
Devices
page. - Save the file wherever you want on your computer.
Import devices from CSV file
You must first prepare a CSV file containing the list of devices. We recommend that you export the list of KeexyBox devices in order to have a template for creating the import file.
The field of the CSV file are described below.
Field | Description |
---|---|
devicename' | The device name. If a device has the same name in KeexyBox, all settings will be overwritten with the values from the CSV file. |
mac | It is a unique identifier assigned to a network device. This address is used by KeexyBox to recognize the device on the network. Most of time it is written down directly on the device. |
dhcp_reservation_ip | The reserved IP address for DHCP. |
profilename | The name of the profile. If the profile does not exist on KeexyBox, the user will be set to the default profile. |
lang | The language displayed on KeexyBox Web interface for the user who use the device. If the language is unknown by KeexyBox the default KeexyBox langage will be set. |
enabled | 1 to enable the device, 0 or empty to disable it. |
Do not change the position of the fields.
When your file is ready:
- Click on at the top of
Devices
page. - On
Select csv file
click onBrowse
. - Select the CSV file to import.
- Click on
Save
.
Bulk actions
Bulk actions allows you to massively doing actions on devices. On the Devices
page:
- Check boxes to the left of listed devices.
- At the bottom of the page, on the selection menu
(select action)
, choose one of the available actions. - Click on
Run
to confirm the action.
The available actions are discribed below:
Connect
: This action allows you to connect multiples devices to the Internet as decribed on this topic.Disable
: This action allows to prevent connecting devices to the Internet.Enable
: This action allows you to allow connecting devices to the Internet.Change the profile
: This action allows you to change the profile of selected devices.Delete
: This action allows you to delete selected devices.