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

# Upgrade to Iru

> Upgrade your existing Kandji account to the Iru platform. Follow the migration steps and understand what changes for your team.

<div style={{ textAlign: 'left', margin: '1.25rem 0 1.75rem' }}>
  <p
    className="homepage-hero-text"
    style={{
  fontSize: 'clamp(1.35rem, 4vw, 2.15rem)',
  fontWeight: 800,
  lineHeight: 1.25,
  margin: 0,
}}
  >
    Your managed devices, configurations, and data stay with you through the upgrade.
  </p>
</div>

<br />

<Callout icon="calendar-days" color="#F5C518" iconType="regular">
  As part of our transition to Iru, Kandji is deprecated. The deadline to upgrade is **December 1, 2026**.
</Callout>

Iru brings Endpoint, Identity, and Compliance together on one platform. It builds on Kandji with a new interface and expanded capabilities. Apple is still our foundation, and a dedicated Apple team continues to grow. After you upgrade, you can also manage Windows and Android devices alongside your Apple fleet.

The upgrade moves your Kandji tenant to Iru's domain and authentication service. See the [Frequently Asked Questions](#frequently-asked-questions) for more.

<CardGroup cols={2}>
  <Card title="Iru Brand Update" icon="sparkles" href="/en/iru/platform-overview/iru-brand-update">
    Logo, app names, and branding on managed devices.
  </Card>

  <Card title="Iru Navigation and Interface" icon="compass" href="/en/iru/platform-overview/iru-navigation-and-interface">
    Web app navigation, tenant domain, and relocated pages.
  </Card>
</CardGroup>

### Before you upgrade

Complete these steps before you start the upgrade. Standard Authentication is the recommended sign-in method so you can finish the upgrade without getting locked out of the tenant. During the upgrade, Standard Authentication is converted to a passkey. After the upgrade is complete, you can configure and test other sign-in methods without losing access.

<Callout icon="life-ring" color="#2563eb" iconType="regular">
  During the upgrade process, if you get locked out or have any issues, [contact Iru Support](/en/iru/iru-support/access-to-iru-support) immediately for assistance.
</Callout>

<Steps>
  <Step title="Enable Standard Authentication">
    Skip this step if Standard Authentication is already enabled.

    1. In the Kandji web app, navigate to **Settings**.
    2. Select the **Access** tab and find the **Authentication** section.
    3. Select the ellipsis next to **Standard Authentication**.
    4. Select **Enable**.
    5. In the confirmation modal, select **Enable**.
  </Step>

  <Step title="Log out of your Kandji tenant">
    Log out of your Kandji tenant.
  </Step>

  <Step title="Sign in with username and password">
    Sign in to your Kandji tenant with your username and password. Do not use social login or another SSO option.
  </Step>

  <Step title="Set up MFA">
    Skip this step if you already configured multifactor authentication (MFA) for Standard Authentication.

    1. When prompted, scan the registration QR code with a time-based one-time password (TOTP) app, such as Apple Passwords or Google Authenticator.
    2. Enter the TOTP code shown in the app.
    3. Select **Continue**.
    4. Copy your **Recovery Code** and store it in a safe place.
    5. Select the **I have safely recorded this code** checkbox.
    6. Select **Continue**.

    <Frame>
      <img src="https://mintcdn.com/iru/rmUkOoPNOAKfISxD/assets/media/images/iru-migrate-from-kandji-mfa-setup.png?fit=max&auto=format&n=rmUkOoPNOAKfISxD&q=85&s=0f0f1069bd3bf5584e552ba48ed62b8f" alt="MFA setup prompt to scan a QR code with a TOTP app during sign-in" width="816" height="1428" data-path="assets/media/images/iru-migrate-from-kandji-mfa-setup.png" />
    </Frame>
  </Step>

  <Step title="Continue with Start Upgrade">
    Continue with [Start Upgrade](#complete-the-upgrade).
  </Step>
</Steps>

### Complete the upgrade

These steps walk you through reviewing and reconfiguring your authentication connections, then completing the migration. After it finishes, all active sessions in the Kandji web app will end, including your own, and you will need to re-authenticate with your new configuration. Sign in at your Iru domain, `{{subdomain}}.iru.com`.

<Steps>
  <Step title="Start the Upgrade">
    When you log in to the Kandji web app, select **Settings** in the left navigation, then select **Access**. You will see a card prompting you to upgrade to unified authentication. Select **Start migration** to begin.

    <Frame>
      <img src="https://mintcdn.com/iru/g5XvVqFV1vl7oJEO/assets/media/images/iru-upgrade-to-iru-start-migration.png?fit=max&auto=format&n=g5XvVqFV1vl7oJEO&q=85&s=d96ad21b30560ba4af5bb25f14642f96" alt="Settings Access page showing the Upgrade to unified authentication card with Start migration button" width="1986" height="786" data-path="assets/media/images/iru-upgrade-to-iru-start-migration.png" />
    </Frame>
  </Step>

  <Step title="Review Your Connections">
    If **Standard Authentication** is not listed as **Active** in the migration mapping, return to [Before you upgrade](#before-you-upgrade) and complete those steps first.

    Look over your current authentication setup and configure replacements for SAML, Google, and Microsoft connections. Follow the Iru [Single Sign-On](/en/endpoint/integrations/single-sign-on-integrations/single-sign-on) guides for each connection type. Some configuration details have changed, so you cannot reuse how you configured the connection in Kandji.

    <Warning>
      You are creating a new SSO connection that will replace your existing one. Either use a new app in your identity provider (IdP) or update all ACS URLs, Redirect URLs, SSO URLs, and Entity IDs to match the new values. If Standard Authentication is not enabled, **incorrect configuration could result in getting locked out of your Iru tenant entirely**.
    </Warning>

    <Frame>
      <img src="https://mintcdn.com/iru/PYP901uFFeJeNw5i/assets/media/images/upgrade-to-iru-review-connections.png?fit=max&auto=format&n=PYP901uFFeJeNw5i&q=85&s=c28cd02044b747ad015fec41010020ee" alt="Review connections interface showing current authentication setup with options to configure replacements" width="2122" height="2790" data-path="assets/media/images/upgrade-to-iru-review-connections.png" />
    </Frame>
  </Step>

  <Step title="Set Up Passkeys">
    The migration converts Standard Authentication to a passkey, which replaces your username, password, and MFA. Register a passkey and save it where you can retrieve it when you sign in after the upgrade. Send passkey invitations to other administrators who also use Standard Authentication. For more information, see [Passkeys and Social Login](/en/iru/access/passkeys-and-social-login).

    <Tip>
      On macOS, if you or another administrator is prompted for a passkey but the expected one is not listed, open **System Settings > Privacy & Security > Passkeys Access for Web Browsers** and turn on access for the browser in use. Then close and re-open that browser and try authenticating again. If a team member is locked out after a reset, see [Iru Account Recovery](/en/iru/access/iru-account-recovery).
    </Tip>

    <Frame>
      <img src="https://mintcdn.com/iru/PYP901uFFeJeNw5i/assets/media/images/upgrade-to-iru-setup-passkeys.png?fit=max&auto=format&n=PYP901uFFeJeNw5i&q=85&s=72d0d8f923f83abde90603ad03e0904d" alt="Passkey setup interface showing options to register a passkey and send invitations" width="2122" height="1380" data-path="assets/media/images/upgrade-to-iru-setup-passkeys.png" />
    </Frame>
  </Step>

  <Step title="Select Back to make changes">
    You can select **Back** at any time during the upgrade to return to a previous step and make changes.
  </Step>

  <Step title="Select Continue">
    When finished, select **Continue** to proceed.
  </Step>

  <Step title="Confirm and Complete">
    Review your settings and select <strong><Icon icon="pen" size={14} style={{ display: 'inline-flex', verticalAlign: 'middle', marginRight: '0.2em' }} /> Make changes</strong> if needed. When the settings are correct, check the box to confirm, then select **Complete migration** to finish the upgrade.

    <Frame>
      <img src="https://mintcdn.com/iru/PYP901uFFeJeNw5i/assets/media/images/upgrade-to-iru-confirm-complete.png?fit=max&auto=format&n=PYP901uFFeJeNw5i&q=85&s=8a799b23ba93b6380d8dad98675d0c96" alt="Confirm and complete upgrade interface showing review options and completion button" width="1954" height="1380" data-path="assets/media/images/upgrade-to-iru-confirm-complete.png" />
    </Frame>
  </Step>

  <Step title="Re-authenticate">
    When the upgrade is complete, all logged-in administrators will be signed out of Kandji and need to re-authenticate with your new configuration. Log in using your new Iru domain at `{{subdomain}}.iru.com`.

    If you go to your old Kandji URL (`{{subdomain}}.kandji.io`), you will see a **Your tenant has been migrated to Iru** screen. Select **Login to Iru** to continue to your Iru domain.

    If you followed [Before you upgrade](#before-you-upgrade), sign in with the passkey you created and saved during the migration from Standard Authentication. That passkey replaces your username, password, and MFA.

    <Note>
      The process typically takes just a few minutes, depending on your identity provider and the number of connections.
    </Note>
  </Step>

  <Step title="Test other sign-in methods">
    After you sign in with your passkey, you can log out and test the other sign-in methods you configured. If a method fails, sign back in with your passkey, update the configuration in **Access** ([**Account Menu Button**](/en/iru/platform-overview/account-menu) → **Access**), and test again. See [SSO Setup](/en/endpoint/getting-started/foundation/sso-setup) and [Passkeys and Social Login](/en/iru/access/passkeys-and-social-login).
  </Step>

  <Step title="Migrate Active Directory Certificate Services (if configured)">
    If you used **Active Directory Certificate Services (AD CS)** in Kandji, the tenant upgrade does not replace the **legacy** AD CS Connector on your Windows Server. After you sign in to Iru Endpoint, uninstall that Connector on the server, install the **updated** Connector from your **Iru** tenant, and complete registration approval. Follow [Migrating from Kandji to Iru with AD CS](/en/endpoint/integrations/certificate-services/active-directory-certificate-services/active-directory-certificate-services-ad-cs-integration-overview#migrating-from-kandji-to-iru-with-ad-cs) in **AD CS Integration: Overview** for the full workflow, including when the integration may still show **Connected** until you remove the legacy package.
  </Step>
</Steps>

### Frequently Asked Questions

<AccordionGroup>
  <Accordion title="When do I need to upgrade?">
    The deadline to upgrade is **December 1, 2026**. The upgrade process is available in **Settings** > **Access** when you log in to the Kandji web app. Follow the [steps above](#before-you-upgrade) to complete the upgrade.
  </Accordion>

  <Accordion title="How long does the upgrade take?">
    The upgrade process typically takes just a few minutes, depending on your identity provider and the number of connections.
  </Accordion>

  <Accordion title="Will this affect my end users?">
    End users do not need to take any action. They will notice a slightly updated sign-in experience during device enrollment and the new enrollment portal domain (`{{subdomain}}.iru.com/enroll` instead of `{{subdomain}}.kandji.io/enroll`).
  </Accordion>

  <Accordion title="What if I need help with the upgrade?">
    Email [support@iru.com](mailto:support@iru.com) or [contact Iru Support](/en/iru/iru-support/access-to-iru-support) if you need help with the upgrade process or have questions.
  </Accordion>

  <Accordion title="Can I test the new authentication before fully upgrading?">
    The upgrade process includes a review step where you can confirm your settings before completing the transition.
  </Accordion>
</AccordionGroup>

### Related Articles

After you sign in to Iru, use these articles to see what looks different, where settings and pages moved, and how to finish authentication setup for any additional SSO connections you need.

<CardGroup cols={2}>
  <Card title="Iru Brand Update" icon="sparkles" href="/en/iru/platform-overview/iru-brand-update">
    Logo, app names, and branding on managed devices.
  </Card>

  <Card title="Iru Navigation and Interface" icon="compass" href="/en/iru/platform-overview/iru-navigation-and-interface">
    Web app navigation, tenant domain, and relocated pages.
  </Card>

  <Card title="Account Menu" icon="user-gear" href="/en/iru/platform-overview/account-menu">
    Tenant-wide settings, including Access, at the bottom of the sidebar.
  </Card>

  <Card title="SSO Setup" icon="right-to-bracket" href="/en/endpoint/getting-started/foundation/sso-setup">
    Set up single sign-on for your tenant after the upgrade.
  </Card>

  <Card title="Single Sign-On" icon="shield-check" href="/en/endpoint/integrations/single-sign-on-integrations/single-sign-on">
    Iru SSO connection guides for Google, Microsoft, Okta, and other identity providers.
  </Card>

  <Card title="Passkeys & Social Login" icon="key" href="/en/iru/access/passkeys-and-social-login">
    Passkeys, social login, and authenticator management.
  </Card>
</CardGroup>
