> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.kodelabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sign in and workspace

> Install KODE OS, enter your workspace, and sign in with email or Microsoft SSO on iOS or Android.

Use your organization workspace to open KODE OS on a phone or tablet. After you enter the workspace domain, the app opens a secure web sign-in view hosted on `accounts.kodelabs.com` or your identity provider.

A **workspace** is your company login address, usually ending in `.kodelabs.com`.

## Install the app

Download KODE OS from the [Apple App Store](https://apps.apple.com/om/app/kode-os/id1479690443) or [Google Play](https://play.google.com/store/apps/details?id=com.kodelabs.klp\&hl=en_US\&gl=US).

## Sign-in flow

<Steps>
  <Step title="Enter your workspace domain">
    Open KODE OS and type your workspace URL (for example, `yourcompany.kodelabs.com`). Tap `Continue`.

    <div className="flex justify-center w-full my-4">
      <Frame className="w-fit mx-auto">
        <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/MYYnSdKhTqQf34f4/images/mobile-app/kode-os-mobile-workspace-sign-in.png?fit=max&auto=format&n=MYYnSdKhTqQf34f4&q=85&s=e5e14d9d1e08b3a21f04f04fe1dd33f6" alt="Sign in to your workspace screen with workspace domain field and Continue button" width="400" height="867" data-path="images/mobile-app/kode-os-mobile-workspace-sign-in.png" />
      </Frame>
    </div>

    <Info>
      Some organizations use `kodemobile` on the first screen. Your administrator can confirm which workspace value to enter.
    </Info>
  </Step>

  <Step title="Allow the sign-in session">
    On iOS, confirm the system prompt so KODE OS can use `accounts.kodelabs.com` to sign you in. Tap `Continue`.

    <div className="flex justify-center w-full my-4">
      <Frame className="w-fit mx-auto" caption="iOS permission before the web sign-in view opens">
        <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/MYYnSdKhTqQf34f4/images/mobile-app/kode-os-mobile-sign-in-sso-prompt.png?fit=max&auto=format&n=MYYnSdKhTqQf34f4&q=85&s=9f699e51c54a461d63a1fa632bc2e692" alt="iOS dialog asking to allow KODE OS to use accounts.kodelabs.com to sign in" width="400" height="867" data-path="images/mobile-app/kode-os-mobile-sign-in-sso-prompt.png" />
      </Frame>
    </div>
  </Step>

  <Step title="Choose a sign-in method">
    The branded sign-in page loads in the web view. Options depend on how your organization is configured.

    <Tabs>
      <Tab title="Email and password">
        Use `Sign in with Email` when your organization allows local credentials.

        <div className="flex justify-center w-full my-4">
          <Frame>
            <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/MYYnSdKhTqQf34f4/images/mobile-app/kode-os-mobile-sign-in-email.png?fit=max&auto=format&n=MYYnSdKhTqQf34f4&q=85&s=9e5f160e87a7b848b5508ad47d91ee9f" alt="Sign in with email and password fields and Sign in with Email button" width="400" height="867" data-path="images/mobile-app/kode-os-mobile-sign-in-email.png" />
          </Frame>
        </div>

        | Field / control         | Action                                                 |
        | ----------------------- | ------------------------------------------------------ |
        | `Email`                 | Enter your Launchpad email                             |
        | `Password`              | Enter your password (use the eye icon to show or hide) |
        | `Forgot password?`      | Open the password reset flow                           |
        | `Sign in with Email`    | Submit credentials                                     |
        | `Other sign in methods` | Return to alternate providers                          |
      </Tab>

      <Tab title="Microsoft SSO (Azure AD)">
        **Single sign-on (SSO)** lets you use your work Microsoft account instead of a separate KODE password. When Azure AD is available, select `Sign in with Azure AD`.

        <div className="flex justify-center w-full my-4">
          <Frame>
            <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/MYYnSdKhTqQf34f4/images/mobile-app/kode-os-mobile-sign-in-azure-ad.png?fit=max&auto=format&n=MYYnSdKhTqQf34f4&q=85&s=aa42045e262591c2521979a3d4cf0187" alt="Sign in page with Sign in with Azure AD button managed by KODE Labs" width="400" height="867" data-path="images/mobile-app/kode-os-mobile-sign-in-azure-ad.png" />
          </Frame>
        </div>

        The page notes that sign-in is managed by KODE Labs. Use `Go Back` if you need to change workspace or method.

        Azure AD then opens the Microsoft sign-in experience. Enter your work email and select `Next`, or use `Sign-in options` for multi-factor authentication (MFA) or alternate methods.

        <div className="flex justify-center w-full my-4">
          <Frame>
            <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/MYYnSdKhTqQf34f4/images/mobile-app/kode-os-mobile-sign-in-microsoft.png?fit=max&auto=format&n=MYYnSdKhTqQf34f4&q=85&s=53ddcd26b27f728429ebe7bbf7727511" alt="Microsoft online sign-in page for KODE Labs with email field and Next button" width="400" height="867" data-path="images/mobile-app/kode-os-mobile-sign-in-microsoft.png" />
          </Frame>
        </div>

        Complete any MFA prompts your organization requires. When authentication succeeds, the web view closes and KODE OS loads your apps.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Select your organization">
    If your account belongs to more than one organization, choose the one you need on the [Organizations](/products/mobile-app/get-started/navigation#organization-context) screen. You can switch later from profile settings.
  </Step>
</Steps>

## Troubleshooting

| Issue                  | What to try                                                                                                               |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| Wrong workspace        | Tap back, re-enter the correct `*.kodelabs.com` domain, and tap `Continue` again                                          |
| Sign-in web view blank | Close the app, check network or VPN, and retry                                                                            |
| SSO loop               | Confirm your email is assigned to the organization in [Launchpad](/products/launchpad/get-started/workspaces-and-sign-in) |
| Forgot password        | Use `Forgot password?` on the email sign-in page or reset from your workspace URL in a browser                            |
| No mobile access       | Ask your administrator to verify your user and app entitlements                                                           |

## Next steps

<CardGroup cols={2}>
  <Card title="Navigate the app" icon="compass" href="/products/mobile-app/get-started/navigation" arrow={true}>
    Move between portfolio, site, and modules.
  </Card>

  <Card title="Customize experience" icon="settings" href="/products/mobile-app/get-started/customize-experience" arrow={true}>
    Manage profile, theme, and organizations.
  </Card>
</CardGroup>