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

1. 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 passphrase" by the data you set before when downloading the configuration file:

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

Customizing the configuration directory

By default, Digibeectl stores its configuration files in the ~/.digibeectl/ directory. However, you can customize this location by setting the DIGIBEECTL_PATH environment variable. Use the following commands to specify your preferred directory:

• Unix-based systems (Linux, macOS): Run the command in the terminal or add it to your shell configuration file.

export DIGIBEECTL_PATH=/custom/path/to/config/directory

• Windows: Run the command in the terminal or follow this tutorial to configure it through the interface.

set DIGIBEECTL_PATH=/custom/path/to/config/directory

Ensure the specified directory exists and that you have the necessary read and write permissions. If the path doesn't end with a forward slash (/), it will be added automatically.

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