User Tools

Site Tools


devices_manage

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.

To manage devices:

  1. Use your browser and connect to the KeexyBox Management Web interface.
  2. On left menu, go to Connection settings → Devices.
  3. 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.

There are 2 ways to declare devices to KeexyBox:

  • Manually.
  • By scanning your network.

Add devices manually

  1. Click on at the top of Devices page.
  2. 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:

  1. Click on at the top of Devices page (This may take time depending on the size of your network).
  2. You will get a list of devices found on your network.
  3. The device brand Name and the IP address can help you recognize your devices.
  4. 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).
  5. At the bottom of the page, in the selection menu (select profile), select the profile you want to set for devices.
  6. 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

  1. On the Devices page, identify in the list the device you wish to modify.
  2. Click on Edit button.
  3. Click Save.

Edit a device

FieldDescription
NameThe device name.
MAC addressIt 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.
ProfileSelect the connection profile.
LanguageSelect 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.
EnableCheck to allow connection of the device to the Internet.

Delete a device

  1. On the Devices page, identify in the list the device you wish to delete.
  2. Click on delete button.
  3. 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

  1. Click on at the top of Devices page.
  2. 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.

FieldDescription
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.
macIt 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_ipThe reserved IP address for DHCP.
profilenameThe name of the profile. If the profile does not exist on KeexyBox, the user will be set to the default profile.
langThe 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.
enabled1 to enable the device, 0 or empty to disable it.

:!: Do not change the position of the fields.

When your file is ready:

  1. Click on at the top of Devices page.
  2. On Select csv file click on Browse.
  3. Select the CSV file to import.
  4. Click on Save.

Bulk actions

Bulk actions allows you to massively doing actions on devices. On the Devices page:

  1. Check boxes to the left of listed devices.
  2. At the bottom of the page, on the selection menu (select action), choose one of the available actions.
  3. 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.

About KeexyBox Project:

devices_manage.txt · Last modified: 2020/09/25 09:47 by paul