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

# Installing Desktop

export const TroubleshootSolution = ({children}) => <>
    <hr className="my-3 w-full" />
    <details className="mt-3">
      <summary className="cursor-pointer font-semibold text-base mb-1">
        Solution
      </summary>
      <div className="mt-2 ml-4" data-component-part="step-content">
        {children}
      </div>
    </details>
  </>;

export const TroubleshootCause = ({children}) => <details className="mt-3 mb-2">
    <summary className="cursor-pointer font-semibold text-base mb-1">
      Cause
    </summary>
    <div className="mt-2 ml-4" data-component-part="step-content">
      {children}
    </div>
  </details>;

export const TroubleshootTitle = ({children}) => <>
    <p className="m-0 font-semibold text-xl leading-tight mb-2" role="heading" aria-level={3}>
      {children}
    </p>
    <hr className="my-3 w-full" />
  </>;

export const Troubleshoot = ({children}) => <div className="callout my-4 px-5 py-4 overflow-hidden rounded-2xl flex gap-3 border troubleshoot-admonition dark:troubleshoot-admonition" data-callout-type="troubleshoot">
    <div className="mt-0.5 w-4">
      <svg width="14" height="14" viewBox="0 0 640 640" fill="currentColor" className="w-4 h-4" aria-label="Troubleshoot">
        <path d="M541.4 162.6C549 155 561.7 156.9 565.5 166.9C572.3 184.6 576 203.9 576 224C576 312.4 504.4 384 416 384C398.5 384 381.6 381.2 365.8 376L178.9 562.9C150.8 591 105.2 591 77.1 562.9C49 534.8 49 489.2 77.1 461.1L264 274.2C258.8 258.4 256 241.6 256 224C256 135.6 327.6 64 416 64C436.1 64 455.4 67.7 473.1 74.5C483.1 78.3 484.9 91 477.4 98.6L388.7 187.3C385.7 190.3 384 194.4 384 198.6L384 240C384 248.8 391.2 256 400 256L441.4 256C445.6 256 449.7 254.3 452.7 251.3L541.4 162.6z" />
      </svg>
    </div>
    <div className="prose min-w-0 w-full">{children}</div>
  </div>;

This guide walks you through downloading and installing Anaconda Desktop.

## Downloading the installer

To download the Desktop installer:

1. Navigate to Desktop's product page on [Anaconda.com](https://www.anaconda.com/products/desktop).

   <Note>
     Choose an installer that works for your operating system architecture. Currently, Anaconda Desktop is available for Windows 11, macOS 13 or later, and Linux.
   </Note>

2. Click **Download**.

For Anaconda Platform users:

1. Open a browser and navigate to `https://<FQDN>` (or `http://<FQDN>` if you are *not* using SSL) where `<FQDN>` is the fully qualified domain name for your designated instance of Anaconda Platform.

2. Select the installer for your operating system architecture.

3. Click **Download**.

## Installing Desktop

Once the installer has downloaded, complete the installation process for your system:

<Tabs>
  <Tab title="Windows">
    1. Select the download file to launch the installer.
    2. Once installation is complete, Anaconda Desktop will automatically launch.
  </Tab>

  <Tab title="macOS">
    1. Select the download file to launch the installer.
    2. Drag and drop the Anaconda Desktop icon onto the Applications folder.
    3. Open Anaconda Desktop from your Applications folder.
  </Tab>

  <Tab title="Linux">
    1. Select the download file to open it in the App Center.
    2. Select **Install**.
    3. Launch Anaconda Desktop from your applications menu.

    <Note>
      These steps describe the Ubuntu GUI installation process. Your Linux distribution may handle `.deb` file installation differently.
    </Note>
  </Tab>
</Tabs>

Sign in with your Anaconda account credentials to begin using Anaconda Desktop. See the [Getting started with Desktop](/docs/anaconda-desktop/getting-started-desktop) guide to learn how to manage environments, launch applications, and work with AI models.

## Troubleshooting

<Troubleshoot>
  <TroubleshootTitle>
    ### Anaconda Desktop won't open on Linux
  </TroubleshootTitle>

  <TroubleshootCause>
    There are two common causes for Anaconda Desktop silently failing to open on Linux:

    * **Wayland session:** Anaconda Desktop is built on Electron, which cannot render UI under Wayland. If your Linux session is running Wayland instead of X11, the app fails to open with no visible error.
    * **Keyring not initialized:** The GNOME Keyring or KWallet is out of sync with your current user password. This typically happens when the password is changed via `passwd` in the terminal rather than through your Linux system settings, which bypasses the PAM module that normally updates the keyring.
  </TroubleshootCause>

  <TroubleshootSolution>
    Run the following command to check your session type:

    ```bash theme={null}
    echo $XDG_SESSION_TYPE
    ```

    * If the output is `wayland`, follow the steps in the **Wayland session** tab.
    * If the output is `x11`, run `anaconda-desktop` from the terminal and check the output for any errors relating to the keyring. If you see keyring-related errors, follow the steps in the **Keyring not initialized** tab.

    <Tabs>
      <Tab title="Wayland session">
        Launch Anaconda Desktop with the X11 platform flag:

        ```bash theme={null}
        anaconda-desktop --ozone-platform=x11
        ```
      </Tab>

      <Tab title="Keyring not initialized">
        Delete the old login keyring file so it can be regenerated:

        <Tabs>
          <Tab title="GNOME Keyring">
            ```bash theme={null}
            rm ~/.local/share/keyrings/login.keyring
            ```
          </Tab>

          <Tab title="KDE (KWallet)">
            ```bash theme={null}
            rm ~/.local/share/kwalletd/kdewallet.kwl
            ```
          </Tab>
        </Tabs>

        Log out and back in. The keyring will be recreated and synced with your current password automatically.
      </Tab>
    </Tabs>
  </TroubleshootSolution>
</Troubleshoot>