Manage sign-in and sessions
Your account is the key to every organization you belong to, so it is worth controlling how you sign in and where you stay signed in. This page covers the sign-in methods an instance offers, how to add a passkey, and how to sign out a device that you no longer use or trust.
Sign-in methods
Section titled “Sign-in methods”The methods available to you depend on how your instance is configured.
| Method | Availability |
|---|---|
| Email code | The instance has email configured. Without email, Orchard hides this option. |
| Passkey | The instance is served over HTTPS. Browsers do not offer passkeys over plain HTTP. |
| Identity provider | A superadmin or your organization has added a provider. |
| Password | Superadmin accounts. On an instance with no email, also people who joined by invitation link. An operator can reset a password on the host. |
| One-time link | An operator prints the link on the host. The link works once and expires after 10 minutes. |
If your organization requires single sign-on, other methods stop working for your account.
Add a passkey
Section titled “Add a passkey”A passkey lets you sign in with Touch ID, Face ID, Windows Hello, or a hardware key. A passkey only works on the site that created it, so a phishing page cannot use it.
- Go to Account settings > Passkeys and devices.
- Select Add passkey.
- (Optional) Enter a name for the passkey, such as
MacBook. - Follow the prompts from your browser.
Add more than one passkey if passkeys are your only sign-in method. If you lose your only passkey and your instance has no email, a superadmin must help you sign in.
To rename or remove a passkey, select Rename or Remove on its row.
Sign in on an instance without email
Section titled “Sign in on an instance without email”An instance without email has no email codes. If you operate the instance, use one of the following commands on the host:
sudo orchardctl login # print a one-time sign-in linksudo orchardctl password set # set a password on the superadmin accountFor the options of each command, refer to orchardctl login and orchardctl password.
Review your devices
Section titled “Review your devices”The Devices list shows each session on your account, with its device name, location, IP address, and last activity. A browser session expires after seven days.
MCP connections also appear in this list, because each connection is a session on your account.
- Go to Account settings > Passkeys and devices.
- Review the Devices list.
Sign out of a device
Section titled “Sign out of a device”To sign out one device:
- Go to Account settings > Passkeys and devices.
- In Devices, select Sign out on the device row.
- Confirm with Sign out.
To sign out every device except this one:
- In Devices, select Sign out others.
- Confirm with Sign out all.
orchard auth session listorchard auth session revoke <SESSION_ID>orchard auth session revoke-allUse this option if you lose a device or think that someone else has access to your account.
Related resources
Section titled “Related resources”- Manage API tokens - Create and revoke the tokens that scripts, CI jobs, and MCP clients use.
- Set up SSO - Let people in your organization sign in through your identity provider.
- Manage SSH identities - Add the public keys that reach your Greenhouse machines.