Skip to content
RavenstashRavenstashRavenstash

Sign in and manage profiles

Sign in

Section titled “Sign in”
Terminal window
rvs auth login

Approve the request in your browser. The CLI never asks for your Ravenstash password. Check the result with:

Terminal window
rvs auth status
rvs auth whoami

The default sign-in lasts up to 180 days. You can request a shorter period from 12 hours to 180 days:

Terminal window
rvs auth login --duration 12h

Choose a personal account or organization

Section titled “Choose a personal account or organization”

Signing in gives you access to the personal account and organizations available to your user. Choose one with your username or the organization’s public handle:

Terminal window
rvs account list
rvs account switch Avery
rvs account switch AcmeHQ

See Choose an account and repository for the normal setup flow.

Use separate profiles

Section titled “Use separate profiles”

Most people need only the default profile. Named profiles are useful when the same computer needs separate Ravenstash sign-ins:

Terminal window
rvs auth login --profile work
rvs auth login --profile personal
rvs profile list
rvs profile use work

You can also inspect, rename, or delete them:

Terminal window
rvs profile current
rvs profile rename work company
rvs profile delete personal

Set RVS_PROFILE when every command in the current shell should use one profile:

Terminal window
export RVS_PROFILE=company

Keep credentials safe

Section titled “Keep credentials safe”

rvs uses your operating system’s secure credential storage when available. It can also use pass or Ravenstash’s encrypted local vault. Run these commands if you need to check or set up storage:

Terminal window
rvs auth storage doctor
rvs auth storage setup

Plain-text storage is available only after an explicit warning and should be reserved for environments that cannot use a secure option.

Use an automation token

Section titled “Use an automation token”

For CI and other unattended jobs, provide an automation token from the job’s secret store:

Terminal window
export RVS_TOKEN="${TOKEN_FROM_SECRET_STORE}"
rvs auth whoami

Do not save the token in project files, shell profiles, build output, or the rvs configuration file.

Sign out

Section titled “Sign out”
Terminal window
rvs auth logout

To remove credentials from every local profile:

Terminal window
rvs auth logout --all

Signing out does not delete repositories or revoke automation tokens. You can review and revoke unfamiliar CLI sessions in Ravenstash account settings.