Aiven Client is a command line tool for fully managed services. To use Aiven Client you need to first create an authentication token and then configure it to connect to your Managed Service for TimescaleDB using the command line.

To connect to Managed Service for TimecaleDB using Aiven Client you need to create an authentication token.

  1. Sign in to your Managed Service for TimescaleDB portal.
  2. Click User Information in the top right corner.
  3. In the User Profile page, navigate to the Authenticationtab.
  4. Click Generate Token.
  5. In the Generate access token dialog, type a descriptive name for the token and leave the rest of the fields blank.
  6. Copy the generated authentication token and save it.

Aiven Client is provided as a Python package, so you can install it on a Linux, MacOS, or Windows system using pip, if you have already installed Python.

Use this command:

pip install aiven-client

For more information about installing the Aiven Client, see the Aiven documentation.

To access Managed Service for TimescaleDB with the Aiven Client, you need an authentication token. Aiven Client uses this authentication token to access your services on Managed Service for TimescaleDB.

  1. Change to the install directory that contains the configuration files:

    cd ~/.config/aiven/
  2. Open the aiven-credentials.json using any editor and update these lines with your Managed Service for TimescaleDB User email, and the authentication token that you generated :

    "auth_token": "ABC1+123...TOKEN==",
    "user_email": "[email protected]"
  3. Save the aiven-credentials.json file.

  4. To verify that you can access your services on Managed Service for TimescaleDB, type:

    avn project list

    This command shows a list of all your projects:

    ============= ======================= ===================
    project-xxxx timescale-aws-us-east-1 xxxx-xxxx-xxxx-xxxx
    project-yyyy timescale-aws-us-east-1 xxxx-xxxx-xxxx-xxxx
    project-zzzz timescale-aws-us-east-1 xxxx-xxxx-xxxx-xxxx

Found an issue on this page?

Report an issue!