Skip to main content
Version: v1.1

Install Aos CLI Tools

The Aos CLI tools are required to get access to the AosCloud UI and API.

Below are explained for each OS.

  • Supported OS versions
  • Install Aos CLI Tools
  • Install Aos root certificate

Prerequisite​

Appropriate Python environment is prepared. See Install Python for detail.

Install Aos CLI Tools​


Supported OS versions​

  • Windows 10
  • Windows 11

Install Aos CLI tools​

Run below command:

~/.aos/venv/Scripts/python -m pip install --upgrade aos-keys aos-signer aos-prov
Example output

PS C:\Users\User> ~/.aos/venv/Scripts/python -m pip install --upgrade aos-keys aos-signer aos-prov
PS C:\Users\User> python -m venv "$env:USERPROFILE/.aos/venv"
Collecting aos-keys
Collecting aos-signer
Collecting aos-prov
....
Installing collected packages: asn1crypto, urllib3, types-python-dateutil, six, semver, ruamel.yaml, rpds-py, PyJWT,
pygments, pycparser, protobuf, mdurl, idna, grpcio, charset-normalizer, chardet, certifi, attrs, requests, referencing,
python-dateutil, markdown-it-py, cffi, rich, jsonschema-specifications, cryptography, arrow, jsonschema, isoduration,
aos-keys, aos-signer, aos-prov
Successfully installed PyJWT-2.10.1 aos-keys-1.8.0 aos-prov-5.1.0 aos-signer-1.16.0
arrow-1.3.0 asn1crypto-1.5.1 attrs-25.3.0 certifi-2025.1.31 cffi-1.17.1 chardet-5.2.0 charset-normalizer-3.4.1
cryptography-42.0.4 grpcio-1.71.0 idna-3.10 isoduration-20.11.0 jsonschema-4.23.0
jsonschema-specifications-2024.10.1 markdown-it-py-3.0.0 mdurl-0.1.2 protobuf-3.20.1 pycparser-2.22
pygments-2.19.1 python-dateutil-2.9.0.post0 referencing-0.36.2 requests-2.32.3 rich-13.9.4 rpds-py-0.23.1
ruamel.yaml-0.18.10 semver-3.0.4 six-1.17.0 types-python-dateutil-2.9.0.20241206 urllib3-2.3.0
[notice] A new release of pip is available: 24.3.1 -> 25.0.1
[notice] To update, run: C:\Users\User\.aos\venv\Scripts\python.exe -m pip install --upgrade pip
PS C:\Users\User>


Install Aos root certificates​

Run below command:

~/.aos/venv/Scripts/python -m aos_keys install-root

If the certificates are not present in the system, Windows may ask you to confirm the installation.

Press Yes to proceed and complete the installation.

Security warning window Security warning window2

Example output

PS C:\Users\User> ~/.aos/venv/Scripts/python -m aos_keys install-root
Root "Trusted Root Certification Authorities"
Signature matches Public Key
Related Certificates:
Exact match:
Element 0:
Serial Number: fc24d8d15f4833e3
Issuer: C=UA, L=Kyiv, OU=Novus Ordo Seclorum, O=EPAM, E=xyz at epam.com, CN=Fusion Root CA
NotBefore: 10-Apr-18 13:33
NotAfter: 27-Jun-26 13:33
Subject: C=UA, L=Kyiv, OU=Novus Ordo Seclorum, O=EPAM, E=xyz at epam.com, CN=Fusion Root CA
Signature matches Public Key
Root Certificate: Subject matches Issuer
Cert Hash(sha1): ca074d171c82146cc57738b215914fc01ea7990a
Certificate "Fusion Root CA" already in store.
CertUtil: -addstore command completed successfully.
Root "Trusted Root Certification Authorities"
Signature matches Public Key
Related Certificates:
Exact match:
Element 1:
Serial Number: 262248a2965ea9747f4b2f92dfc1c233847e200e
Issuer: CN=AosEdge Root CA, OU=Aos, O=EPAM Inc
NotBefore: 26-Dec-24 14:01
NotAfter: 21-Dec-44 14:01
Subject: CN=AosEdge Root CA, OU=Aos, O=EPAM Inc
Signature matches Public Key
Root Certificate: Subject matches Issuer
Cert Hash(sha1): 4832f41572d3c0f1890b48d03bdd251a84c78b3d
Certificate "AosEdge Root CA" already in store.
CertUtil: -addstore command completed successfully.
PS C:\Users\User>