TimescaleDB: 1. Authenticate

This documentation is part of the Automate with the CLI guide. View the full guide here: Start TimescaleDB, retrieve its credentials, and change its configuration programmatically with the Stackhero CLI.

Welcome to the Stackhero documentation!

Stackhero provides a ready-to-use TimescaleDB cloud solution designed to help you get up and running in minutes. Here is what you can look forward to:

• All the best plugins included, such as PostGIS, PgVector, and more.
• Convenient access to the PgAdmin web UI for easy database management.
• Simple, one-click updates to keep your deployment current.
• Reliable performance and strong security on your own private, dedicated infrastructure.

If you are looking to save time and streamline your workflow, Stackhero's TimescaleDB cloud hosting is designed to make your experience as smooth as possible. You can try it out in as little as 5 minutes!

The easiest way to get started is by logging in through your browser. When you run the login command, the CLI opens a web page where you can approve access. No passwords or 2FA codes are entered into the CLI itself.

stackhero login

After logging in, your credentials are stored locally and will be used automatically by future CLI commands.

For fully automated environments like scripts or CI pipelines, you might prefer a non-interactive access token. You can create one from your dashboard (Account > Access tokens), then export it as an environment variable. The CLI, and any script you run, will pick it up automatically.

export STACKHERO_TOKEN="usr-xxxxxx:your-token"