Skip to content

Latest commit

 

History

History
117 lines (83 loc) · 4.39 KB

_devops-cli-install.md

File metadata and controls

117 lines (83 loc) · 4.39 KB

  1. Install $CLI_LONG

    Use the terminal to install the $CLI_SHORT: 

    curl -s https://packagecloud.io/install/repositories/timescale/tiger-cli/script.deb.sh | sudo os=any dist=any bash
sudo apt-get install tiger-cli
    curl -s https://packagecloud.io/install/repositories/timescale/tiger-cli/script.deb.sh | sudo os=any dist=any bash
sudo apt-get install tiger-cli
    curl -s https://packagecloud.io/install/repositories/timescale/tiger-cli/script.rpm.sh | sudo os=rpm_any dist=rpm_any bash
sudo yum install tiger-cli
    curl -s https://packagecloud.io/install/repositories/timescale/tiger-cli/script.rpm.sh | sudo os=rpm_any dist=rpm_any bash
sudo yum install tiger-cli
    brew install --cask timescale/tap/tiger-cli
    curl -fsSL https://cli.tigerdata.com | sh

  2. Set up API credentials

    1. Log $CLI_LONG into your $ACCOUNT_LONG:

      tiger auth login

      $CLI_LONG opens $CONSOLE_SHORT in your browser. Log in, then click Authorize.

      You can have a maximum of 10 active client credentials. If you get an error, open credentials and delete an unused credential.

    2. Select a $PROJECT_LONG:

      Auth URL is: https://console.cloud.timescale.com/oauth/authorize?client_id=lotsOfURLstuff
Opening browser for authentication...
Select a project:

> 1. Tiger Project (tgrproject)
2. YourCompany (Company wide project) (cpnproject)
3. YourCompany Department (dptproject)

Use ↑/↓ arrows or number keys to navigate, enter to select, q to quit

      If only one $PROJECT_SHORT is associated with your $ACCOUNT_SHORT, this step is not shown.

      Where possible, $CLI_LONG stores your authentication information in the system keychain/credential manager. If that fails, the credentials are stored in ~/.config/tiger/credentials with restricted file permissions (600). By default, $CLI_LONG stores your configuration in ~/.config/tiger/config.yaml.

  3. Test your authenticated connection to $CLOUD_LONG by listing $SERVICE_SHORTs

    tiger service list

    This call returns something like:

    • No $SERVICE_SHORTs:

      🏜️  No services found! Your project is looking a bit empty.
🚀 Ready to get started? Create your first service with: tiger service create

    • One or more $SERVICE_SHORTs:

      ┌────────────┬─────────────────────┬────────┬─────────────┬──────────────┬──────────────────┐
│ SERVICE ID │        NAME         │ STATUS │    TYPE     │    REGION    │     CREATED      │
├────────────┼─────────────────────┼────────┼─────────────┼──────────────┼──────────────────┤
│ tgrservice │ tiger-agent-service │ READY  │ TIMESCALEDB │ eu-central-1 │ 2025-09-25 16:09 │
└────────────┴─────────────────────┴────────┴─────────────┴──────────────┴──────────────────┘