cix login
Authenticates the CLI with your cix account and fetches the credentials your clients use to reach the cix cloud.
$ cix loginA browser window opens for you to sign in. Signing in for the first time creates a free account. When you return to the terminal, your credentials are stored locally.
Flags
| Flag | What it does |
|---|---|
--whoami | Print who you're signed in as, and where the credentials live |
--logout | Clear stored credentials on this machine |
--no-browser | Print the sign-in URL instead of opening a browser |
--timeout SECONDS | How long to wait for the browser round-trip |
cix whoami and cix logout are the same actions as their own commands.
When to run it
- The first time you set up cix.
- If cix doctor reports you are not authenticated.
- After signing out, or on a new machine.
Signing in without a browser
On a server or over SSH, where no browser can open:
$ cix login --no-browsercix prints the URL to open elsewhere and waits for you to finish.
For unattended use — CI, a container, a scripted setup — set CIX_AUTH_TOKEN
in the environment instead of running an interactive sign-in.
Where credentials are stored
Credentials are written to a file in your home directory, readable only by you.
cix login --whoami prints the exact path. Removing cix with --purge-data
deletes them; see Maintenance commands.
Related
- Troubleshooting: Not logged in.
- Full walkthrough: Log in.