Getting started

Learn how to install, configure and update Digibeectl.

This documentation presents the steps that must be performed for Digibeectl to be installed and working correctly.

Download the configuration file

Follow the steps below to get the configuration file:

1. Log in to Digibee Integration Platform.

2. Click on the Administration button.

3. Click in Digibeectl in the menu on the left side of the screen.

4. Click on the Create button.

5. Give a title to your token.

6. Insert a list of permissions to be granted to this token.

7. Set an expiration period for your token. The period ranges from 1 hour to 1 year.

8. Save your permissions list and expiration period.

9. Copy the Encryption Key generated by the Platform using the copy icon and save it to further use. Then, create the file password.

10. Save the password and download the file.

Run the installation

Digibeectl is available as a ‘tar.gz’ file for MacOs and Linux.

While Windows does not have native support, it can be installed by setting up WSL (Windows Subsystem for Linux), allowing the tool to be installed and configured in a Linux environment within Windows. Check the documentation to know how to install Digibeectl on Windows.

1. To install the file, open a terminal window and run the command line below:

curl -s https://storage.googleapis.com/digibee-release-test/releases/install.sh | bash

2. Use the following command line after install Digibeectl. Replace the words “path/file.json” by the configuration file address and the words "encryption key" and "encryption password" by the data you set before when downloading the configuration file:

digibeectl set config --file "path/file.json" --secret-key "encyption-key" --auth-key "encryption-password"

Download the updates

To update Digibeectl, run the installation line again. To do this, open a terminal window and type:

curl -s https://storage.googleapis.com/digibee-release-test/releases/install.sh | bash