Skip to main content

Your profile

Your profile is the Personal group of Settings: the settings of your own account. Everyone can open it, whatever their role. It changes only your account, never another person's.

Open it from your account menu: select your initials at the bottom of the sidebar, then My Profile. Settings in the sidebar opens it too. See Find your way around.

Its items are Profile, Preferences (your interface settings, then Notifications, where your alerts go), Security and Git, listed first in the category list on the left of Settings. Below them, depending on your role, come your organization's settings under Organization and Customize; see Settings. Search settings above the list finds each Personal setting by name or by what it does, for example dark mode or API keys. Selecting a result opens its page and highlights that setting.

Settings opened on Personal › Profile: Search settings above the category list, Personal's four items first

Save your changes​

One Save button at the bottom of the page saves Profile and Preferences together. You can change fields in both, then select Save once.

Save is greyed out until you change something, with No changes beside it. After a save, Saved appears at the top of the page. If the save fails, the reason appears there instead, for example Failed to save or The new password must be at least 8 characters. A password problem takes you back to Profile.

Notifications, Git and Security don't use Save: each of their choices and buttons acts at once. They show Save only while a change elsewhere is waiting.

Leaving the page with a change not saved, for example for another Settings category, asks first, under Unsaved changes: Save saves and leaves, Discard leaves without saving, and Cancel stays. Moving between Personal's items keeps your change and doesn't ask.

Profile​

Profile: Email, First name, Last name, Set new password and Save

FieldMeaning
EmailThe address you sign in with. You can't change it here. Its help reads Your sign-in address; an admin or Support changes it.
First name, Last nameYour name, as other people see it in Jaah. Their help reads Shown for this account everywhere instead of the email.
Set new passwordA new password, at least 8 characters. Its help line reads Replaces the sign-in password and forgets every trusted device. Left blank (Leave blank to keep unchanged), your password stays as it is.

Until you set a first or last name, a note at the top says Add your name. Where your organization can invite people, it adds Others see your email.

Changing your password also removes all your trusted devices. See Security.

Preferences​

How the console looks for you, under Interface. Your alerts, under Notifications, follow it: see Alerts.

Preferences: Interface with the Theme dropdown

Hover a setting's name for a one-line explanation.

SettingMeaning
ThemeA dropdown of the console's colours: Default (follows the theme your operator set, shown in brackets, such as Default (Light)), Light (always light) or Dark (always dark). The theme changes when you select Save, not when you pick it.

Alerts​

Part of Preferences, under Interface: the Notifications card: where Jaah sends your alerts, and which ones. Every choice saves as soon as you change it.

Preferences: Interface with Theme, then Notifications with the Add channel button, an open Email row with Collapse and its ⋯ menu, and its groups, each with its Off, Brief or Full dropdown

Channels​

A channel is one place alerts go: an email address, a Slack DM, a Slack channel, a Telegram chat, or Browser (every browser you turned notifications on in; one row for all of them). You can have several of each type, for example your sign-in address and a team mailbox. Each row shows the type and the full destination: the address, the Slack name or #channel, the Telegram chat's name, or how many browsers get notifications, each listed under the row (This browser marks the one you are using). With no channel, the list says No channels. Nothing is sent. In a HIPAA organization, a Slack or Telegram row's alerts carry the warning Not covered by a BAA — don’t send PHI here. unless a BAA covers that service.

A row that can't deliver yet carries a chip; hover it for the fix.

ChipMeaning
UnverifiedAn email address not confirmed yet. See Confirm an email address.
Not linkedThe Telegram chat was unlinked, for example the bot was removed from it. Remove the row and link the chat again with Add channel.
No browsersEvery browser of the Browser row was turned off or blocked notifications. Turn them on in a browser again with Add channel.
Reconnect SlackYour organization's Slack workspace isn't connected. An Org Owner or Org Admin connects it again: see Connect Slack.
Wrong workspaceThe Slack row was added in another Slack workspace. On a Slack DM, select ⋯, then Reconnect; on a Slack channel, remove it and add it again.

Each row's ⋯ menu holds Remove: it asks Remove channel? first, then stops alerts to that destination only. Your other channels stay as they are.

Add a channel​

Select Add channel, then pick what to add. An option you can't use is greyed out with the reason, for example Not on your plan or Slack isn't connected; one Jaah doesn't offer is not listed. With nothing to add, Add channel itself is greyed out (Nothing to add).

OptionWhat happens
EmailAdd email asks for one Email (We'll email a link and a code to confirm it.). Type an address and select Add. Jaah emails it a link and a 6-digit code; the row shows Unverified until you confirm. When you have no channel to your sign-in address, the field starts with it. An address already in your list is refused.
Slack DMYour own chat with the Jaah app. Connect Slack shows a code: in Slack, send it to @Jaah before it expires (Open Slack, when shown, opens that chat). The row appears once Slack hears the code. Needs a plan that includes Slack and a connected workspace.
Slack channelOrg Owners and Org Admins only. Pick a channel of your organization's Slack workspace; Filter narrows the list. Invite the Jaah app to a private channel first, or it isn't listed. Everyone in the channel sees the alerts you can see. If the option is greyed out with Reconnect Slack in Settings to add channels, or the list says Slack must be reconnected to list channels., an Org Owner or Org Admin reconnects Slack in Settings › Integrations.
TelegramConnect Telegram offers two links, valid for 10 minutes. Open private chat opens your own chat with the Jaah bot: tap Start. Add to a group lets you pick a Telegram group: everyone in it sees the alerts you can see. Pick Telegram again for each further chat or group.

| Browser | Turn on in this browser asks the browser for permission, then adds it to your Browser row. On an iPhone or iPad, add Jaah to the Home Screen first and open it from there: see Get notifications in your browser. Pick Browser again in each further browser. |

The Browser row also has Send test, which sends a notification to each of its browsers, and Add this browser when the browser you are using isn't on it.

Slack needs a plan that includes it. The community edition has no Slack, Telegram or browser notifications.

Confirm an email address​

Until an address is confirmed, nothing is sent to it. Its Unverified row carries a line under it that says what to do next:

  • Check your inbox for a link or a 6-digit code. An email has gone out. Under the line are a Code field, Confirm and Resend. Select the link in the email, then the button on the page it opens; or type the code and select Confirm (or press Enter). The link works for 24 hours; the code for 30 minutes and 5 tries.
  • Confirm this address to get alerts here. with Verify: your sign-in address, where nothing is emailed until you ask. Select Verify, and Jaah emails it a link and code.
  • The confirmation email wasn't sent. Use Resend. with Resend: the address was added but its email did not go out. Select Resend to try again.

Resend emails a new link and code; Sent. shows briefly.

While an emailed code is still valid, the Code field and Resend stay on the row, even after you reload the page.

Choose your alerts​

Select a channel's row (Expand) to open its alerts, and again (Collapse) to close it. A lone channel starts open. Each channel has its own choices: for example, everything by Slack but only questions by email.

Alerts come in groups. Beside each is a dropdown with three choices; hover it for what the current one sends:

ChoiceMeaning
OffNothing is sent.
BriefA headline and a link only: no question text and no answer buttons. Several questions asked at once send one message.
FullThe whole message.

Each choice saves as you pick it; if a save fails, the dropdown goes back and the reason shows above the list. A group's dropdown sets every alert in it. On a group of several alerts, select its name (marked with an arrow) to open each alert with its own dropdown; when they differ, the group's dropdown reads Mixed until you pick one choice for all.

GroupAlertsStarts as
Assigned to youAssigned to you, Question waiting (a task asks you something), Compliance nudgeFull
MessagesMentioned (also a new comment on a task you created or are assigned), Reactions (to your comments), Direct messages (sent to you by an agent a task asked to)Full
SupportSupport: news on a ticket you raisedFull
API & automationTrigger stopped; for Org Owners and Org Admins also API key expiry and Automation failuresFull
Task progressFinished, Blocked, Failed, Merge fix filed (the merge lane filed a task to fix a pull request)Off by email, Brief on Slack and Telegram
ReleasesApproval needed (a release waits for your approval), Live (your task reached production), Release failed (a release you asked for), Approval reminder, Approval timed out, RejectedFull
BillingBilling, BudgetsFull
AI account loginLogin expiring, Login code needed (an AI account's login expired and needs a code)Full
Node failuresNode full, Node offline (a node stopped reporting), Runner keeps crashing (on one node)Full

Billing, AI account login and Node failures are shown only to Org Owners and Org Admins. Node offline and Runner keeps crashing send once per episode: not again until the node is back, or has gone a while without a crash.

When channels arrived, every channel's alerts were reset to these defaults, and everyone got an Email channel to their sign-in address. Set your groups again if you had changed them.

Security​

The browsers that skip the sign-in code, and your API keys.

Security: Trusted devices with none yet, and API keys with New key and one revoked key

When your organization allows sign-in only from approved networks, a note at the top says Sign-in is allowed only from approved networks.

Trusted devices lists each browser where you checked Trust this device at sign-in. The one you are using is marked This device. Each row shows when it was trusted, when it was last used (or Not used yet) and when it expires. With none, it says No trusted devices.

  • Select Revoke next to a device to remove it.
  • Select Revoke all, then Revoke all again in Revoke all devices to confirm, to remove every device.

Either one also signs you out everywhere else. See Sign in.

API keys appears here when you belong to an organization. It lists the keys you made, each with its status mark, the key's first and last characters (such as jaah_…eYmw, never the whole key), name, last use, permissions, owner and expiry. A revoked key's row is dimmed and reads Revoked in place of its expiry. New key makes one, a row opens it, and its ⋯ menu holds Open and Revoke. With no key yet, it says No API keys yet. See API keys.

Git​

The Git accounts your tasks run with. A task clones, pushes and opens its pull request with the account of the person who started it, never a teammate's, so to start a task on a project you need an account here with at least read access to its repository. Without one, the task waits and names the fix: connect an account, or ask a teammate who has one to start it. Creating a task needs no account.

New project asks you to connect one when you add an existing repository: its Connect opens a New Git account page (its breadcrumb Profile leads to Git) with the same form, and brings you back with your input kept once the account is connected. Its button reads Connect and the host's name, such as Connect GitHub; Cancel goes back without connecting. You can also add an account here at any time. Your other credentials are in Secrets.

New Git account: Type, Method, the Connect button and Cancel

Git: Add Git account and a connected GitHub row with its ⋯ menu

The table lists each account you connected, one row each:

  • A green ✓ (connected) or an amber ! (Needs reconnect: the account stopped working; hover it for the reason).
  • The host, such as GitHub, with its logo, then · and the account name on the host, or Connected with a token for a pasted token.
  • Under them, the host's web address.
  • ★ Default when you have several accounts on that host and this is the one used for repositories no other account reaches.

With no account, the table says No Git accounts connected and offers Add Git account, which opens the same form. After you connect one, a banner says it is connected and that your runners will push with it. Under the table, Other credentials are in Directory > Secrets. links to your other credentials.

Connect GitHub uses the Jaah GitHub App, unless your operator chose the OAuth App. With the GitHub App, connecting may take you to the App's install page: an organisation owner installs it there, and anyone else can request an owner's approval. After a request, a banner reads Waiting for an organization owner to approve the GitHub App. Until then its repositories are out of reach. With the OAuth App, an account reaches every repository you can reach on GitHub. Under the table, a warning names any organisation behind your projects that blocks it:

  • hasn't installed the Jaah GitHub App: its repositories are out of reach. Select Install or request approval. If the App isn't installed anywhere you can reach, the warning says so.
  • hasn't approved Jaah: the organisation restricts outside apps, so its private repositories are out of reach until an owner approves Jaah. Select Request approval to ask, or paste a token.
  • uses single sign-on: select Authorize and authorize Jaah for that organisation, or paste a token.
ControlWhat it does
Add Git accountAbove the table (a + on a phone). Opens the Add Git account form under the table. Hover it for the hosts it connects, such as Connect GitHub, GitLab, Bitbucket or Azure DevOps. Pick its Type, then a Method, then fill in the fields. Cancel closes the form.
⋯The row menu: Reconnect, Disconnect, and Make default where it applies.
ReconnectConnects the account again, for example after it stopped working. Where the host has no sign-in, it asks for a new token.
DisconnectRemoves the account.
Make defaultShown when a host has several accounts. Makes this one the Default.

Type is GitHub, GitLab, Bitbucket, Azure DevOps or Self-managed GitLab. Add a host again to connect another account on it.

With several accounts on one host, a task uses the account that reaches the repository's owner (its organisation, group or workspace), else the Default. Jaah learns what an account reaches when you connect it and when you create a repository; reconnect an account after it joins a new organisation.

MethodWhat it does
Sign in with the hostSigns you in to the host: select Connect and the host's name. Missing when the host isn't set up yet; a line under Method says so, and an operator sees Sign-in is not set up. with Set it up, which opens that host's setting.
Paste a tokenConnects with a token you create on the host. Enter it in Token, then select Test and connect. Bitbucket asks for an Atlassian email and an API token; Azure DevOps also asks for the Organization the token is tested against.
Use a credential I already addedConnects with a credential you added. Pick it in Credential, then select Use.

For Self-managed GitLab, enter its Base URL and a Token, then select Test and connect.

Not on this page​

  • Email: an admin or Support changes it.
  • Two-factor sign-in: set up when you sign in, not here. See Set up two-factor sign-in.
  • Forgotten password: Forgot password? on the sign-in page. See Reset your password.
  • Sign out: your account menu, under My Profile.
  • Photo, time zone or language: there are none. Your initials stand for you in the sidebar, and times show in your browser's time zone.
  • Deleting the account: only an Owner can, and it deletes the whole organization. See Delete account.