Skip to main content
Version: v1

Linux

Supported Operating Systems​

  • Ubuntu 20.04 LTS
  • Ubuntu 22.04 LTS
  • Ubuntu 24.04 LTS

Operating systems other than the ones listed above may work but are not officially supported or tested.

Tools​

  • Python 3.8+ installed on your system (required)
  • Git installed on your system (optional)
  • Oracle VirtualBox 7+ (optional)

1. Install required libraries​

Run the following commands in the terminal window to update the package lists and install all necessary libraries:

sudo apt update && sudo apt upgrade -y
sudo apt install -y libnss3-tools ca-certificates

2. Prepare Python environment​

In the terminal window, run next commands:

python3 -m venv ~/.aos/venv

3. Verify Python installation​

To verify installation, open a terminal window and run the command to check the Python version (which should be 3.8 or above):

~/.aos/venv/bin/python3 -V

4. Install Aos command-line tools​

~/.aos/venv/bin/python3 -m pip install --upgrade aos-keys aos-signer aos-prov

5. Install Aos root certificate as trusted​

In the terminal window, execute the following command:

~/.aos/venv/bin/python3 -m aos_keys install-root

After this command, it is necessary to install the Aos root certificate system-wide. To do this, run the following command (as suggested by aos-keys install-root script) :

sudo ~/.aos/scripts/install_aos_root_ca.sh

6. Install VirtualBox (optional in case using hardware devices)​

Go to the official website for VirtualBox installation instructions: https://www.virtualbox.org/