Skip to content
redmine-cli

Authentication

The auth command manages authentication profiles for connecting to one or more Redmine instances.

login Interactive login wizard; creates a new profile.
list List all saved authentication profiles.
switch Switch the active authentication profile.
status Show the current auth status.
logout Remove an authentication profile.

login

Section titled “login”

Start an interactive login wizard:

Terminal window
redmine auth login
redmine auth login --name work   # explicit profile name
FlagDescription
--nameProfile name (default: derived from server hostname)

list

Section titled “list”
Terminal window
redmine auth list

Shows each profile’s server URL and which one is currently active.

switch

Section titled “switch”
Terminal window
redmine auth switch

Opens an interactive selector. The picked profile becomes the default for subsequent commands.

status

Section titled “status”
Terminal window
redmine auth status

Displays the active profile name, server URL, and authentication method.

logout

Section titled “logout”
destructive
Terminal window
redmine auth logout              # current profile
redmine auth logout work         # named profile

You will be prompted to confirm before removal.

Quick reference

Section titled “Quick reference”
Terminal window
redmine auth login
redmine auth login --name work
redmine auth list