Login

The CLI uses browser-based OAuth login by default, making authentication quick and easy.

Basic login

qyra login {{ qyra_domain }}

where {{ qyra_domain }} is the subdomain for your Qyra instance. For example, if you login at https://petey.qyraflow.com, then you would type qyra login petey to pop up a login window.

qyra login petey

This opens your browser to authenticate. Once authorized, you're logged in and ready to use the CLI.

Flexible URL formats

The CLI accepts your instance URL in multiple formats, all of these work:

# Just your subdomain (recommended for Qyra Cloud)
qyra login your_subdomain_here

# Full domain without protocol
qyra login your_subdomain_here.qyraflow.com

# Full URL with protocol
qyra login https://your_subdomain_here.qyraflow.com

# Any URL from your Qyra instance (useful for copying from browser)
qyra login https://your_subdomain_here.qyraflow.com/projects/abc123/dashboards

For Qyra Cloud users, you can simply use your subdomain (e.g., petey if your instance is at petey.qyraflow.com).

For self-hosted instances, you can use the full domain without the https:// prefix - it's assumed automatically.

Re-authenticate to a previous instance

Once you've logged in, you can re-authenticate without specifying the URL:

qyra login

This uses your previously saved instance URL.

Set active project

When you login you'll be asked to set an active project.

Your active project is just the one that you're working on/developing in. Your organization might just have one project, so that makes your decision easy!

You can change your active project by running:

qyra config set-project

Or you can use the QYRA_PROJECT environment variable to indicate what project UUID the command should use.

Example:

QYRA_PROJECT="3675b69e-8324-4110-bdca-059031aa8da3" qyra deploy

Now that you've logged in, you're ready to use the CLI

You can see all of the actions available on the CLI by typing this in your terminal:

qyra

Some of our favourites are:

• Automatically generating .yml for your dbt models using the Qyra generate command

• Testing your changes with developer previews using the Qyra preview command

• Deploying your changes to production using the Qyra deploy command