Octri

auth login

Signs you in to Octri. It asks for your email and password, and for your authenticator code if your account has two-factor turned on. It then prints who you are, your organisation and its plan.

The session is stored in the current profile, in ~/.octri/config.json, which only your user can read. Later commands send it for you.

To sign in to another environment, such as a local stack, choose its address first with --api-url or octri config use.

bash
octri auth login [--email <email>] [--password <password>] [--code <code>]

Flags

--email <email>string

Your account's email. Asked for when you leave it out.

--password <password>string

Your password. Asked for, hidden, when you leave it out. Prefer the prompt: a flag value stays in your shell history.

--code <code>string

Your authenticator code, or a backup code, for an account with two-factor. Asked for when it's needed and you leave it out.

--api-url <url>stringdefault: the profile's address

Sign in to this API instead. local is short for a stack on your own machine at localhost:3001.

Examples

Sign in

With no flags, it asks for what it needs.

bash
octri auth login
Output
✔ Email → dana.reyes.park@acme.co.uk
✔ Password → (hidden)
✔ Credentials accepted
✔ Signed in as dana.reyes.park@acme.co.uk · Acme Software (growth)
  profile default → https://api.octri.dev/api/v1
  • octri auth whoami: Print the signed-in user, organisation, plan, role and selected project.
  • octri auth logout: End the session on the server and clear it from this machine.
  • octri config: Show, change and switch profiles: API address, default project and languages.