> ## 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.

# Troubleshooting notebooks

export const Comments = ({children}) => {
  return <div class="my-4 px-5 py-4 overflow-hidden rounded-2xl flex gap-3 border border-zinc-500/20 bg-zinc-50/50 dark:border-zinc-500/30 dark:bg-zinc-500/10" data-callout-type="comments">
      <div class="w-4">
        <svg width="14" height="14" viewBox="0 0 640 640" fill="currentColor" xmlns="http://www.w3.org/2000/svg" class="w-5 h-5" aria-label="Comments">
            <path d="M320 112C434.9 112 528 205.1 528 320C528 434.9 434.9 528 320 528C205.1 528 112 434.9 112 320C112 205.1 205.1 112 320 112zM320 576C461.4 576 576 461.4 576 320C576 178.6 461.4 64 320 64C178.6 64 64 178.6 64 320C64 461.4 178.6 576 320 576zM280 400C266.7 400 256 410.7 256 424C256 437.3 266.7 448 280 448L360 448C373.3 448 384 437.3 384 424C384 410.7 373.3 400 360 400L352 400L352 312C352 298.7 341.3 288 328 288L280 288C266.7 288 256 298.7 256 312C256 325.3 266.7 336 280 336L304 336L304 400L280 400zM320 256C337.7 256 352 241.7 352 224C352 206.3 337.7 192 320 192C302.3 192 288 206.3 288 224C288 241.7 302.3 256 320 256z" />
        </svg>
      </div>
      <div class="text-sm prose min-w-0 w-full">
        {children}
      </div>
    </div>;
};

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 page includes common troubleshooting topics for Anaconda Notebooks.

If you are experiencing issues with conda, see the [Troubleshooting](/reference/troubleshooting) page for workarounds to common issues. For questions about JupyterLab, refer to the official [JupyterLab documentation](https://jupyterlab.readthedocs.io/en/stable/index.html).

<Note>
  If you encounter an issue or bug that isn't covered on this page, you can ask for help in the [Anaconda community forums](https://forum.anaconda.com) or [open a support ticket](https://support.anaconda.com/hc/en-us/requests/new).
</Note>

<Troubleshoot>
  <TroubleshootTitle>
    ### Toolbox environment card says the environment is installed, but no environment in the Launcher or runtime selector
  </TroubleshootTitle>

  <TroubleshootCause>
    The environment might not have fully synchronized with the Launcher or runtime selector yet.
  </TroubleshootCause>

  <TroubleshootSolution>
    First, try refreshing the browser page. If the environment still doesn't appear after refreshing, check the Environments page in Navigator to see if it's available. If the environment is still unavailable after waiting two minutes, close all open Jupyter sessions and restart Jupyter from Navigator or the command line.
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### Quickstart environment installation errored
  </TroubleshootTitle>

  <TroubleshootCause>
    Installation errors can occur due to misconfigured channels in your `.condarc` file, organizational policies blocking installation, connectivity issues, or stale Jupyter kernel states.
  </TroubleshootCause>

  <TroubleshootSolution>
    First, check your `.condarc` file and verify that your channels are set to either `defaults` or `conda-forge`. If your channels are set correctly and you're still experiencing issues, check with your administrator to see if they have defined any policies that could be blocking installation.<br /><br />

    If neither of the above resolves the issue, you can try:

    * Refreshing the page
    * Checking your internet connection
    * Shutting down all running Jupyter kernels and restarting your Jupyter instance
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    <h3 id="cli-or-navigator-gives-error-starting-kernel-message">
      CLI or Navigator gives "error starting kernel" message
    </h3>
  </TroubleshootTitle>

  <TroubleshootCause>
    Uninstalling a quick start environment using either the CLI or Navigator can result in an `Error starting kernel: [Errno 2] No such file or directory` message, because the Jupyter kernel references aren't properly removed when the environment is deleted.
  </TroubleshootCause>

  <TroubleshootSolution>
    To resolve this issue:

    1. Open Anaconda Prompt (Terminal in macOS/Linux)
    2. Run:

       ```sh theme={null}
       jupyter kernelspec list
       ```
    3. Find the name of the quick start environment you deleted.
    4. Then run:
       ```sh theme={null}
       jupyter kernelspec uninstall <ENV_NAME>
       ```
           <Comments>
             Replace \<ENV\_NAME> with the name of the deleted environment.
           </Comments>
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### Published Panel app is blank
  </TroubleshootTitle>

  <TroubleshootCause>
    The app can appear blank if the notebook cannot be executed sequentially from top to bottom, which can happen when cells have dependencies that aren't met or are out of order.
  </TroubleshootCause>

  <TroubleshootSolution>
    If you added content to your app but there's still nothing showing up, ensure that your notebook can be run from top to bottom. The easiest way to test this is to click **Run** in the top menu, then click *Run All Cells*.
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### All CPU seconds have been used up in Notebooks
  </TroubleshootTitle>

  <TroubleshootCause>
    You've used up all your available CPU seconds.
  </TroubleshootCause>

  <TroubleshootSolution>
    CPU seconds are consumed by active runtimes, which can continue to run in the background even after you've logged out of Notebooks or switched to a different browser tab.<br /><br />

    To prevent your CPU seconds from being used while you are not actively using Notebooks, make sure you shut down all runtimes in all open instances of Notebooks before logging off for the day. You can do this from the <Icon icon="circle-stop" iconType="solid" /> **Running Terminals and Kernels** tab:<br /><br />

    <Frame>
      <img src="https://mintcdn.com/anaconda-29683c67/suT8p96bcArryiKX/images/notebook_shutdown_kernel.png?fit=max&auto=format&n=suT8p96bcArryiKX&q=85&s=1453d278be2e3881bfcfb07a4b1e97de" alt="" width="3460" height="1540" data-path="images/notebook_shutdown_kernel.png" />
    </Frame>

    <br />

    If the problem persists, please raise the issue in the [Anaconda community forums](https://forum.anaconda.com) or [file a support ticket](https://support.anaconda.com/hc/en-us/requests/new?ticket_form_id=360000993773).<br /><br />

    You can upgrade your subscription plan to access additional CPU seconds. See our [pricing page](https://www.anaconda.com/pricing) for further details.
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### Error when importing packages in Notebooks
  </TroubleshootTitle>

  <TroubleshootCause>
    The most common cause of errors is a lack of required package(s) installed in your environment. The default environment we provide, based on the Anaconda distribution, contains hundreds of the most common python packages for data science, but it doesn't include everything. You might need to create a custom environment to install the package you need.
  </TroubleshootCause>

  <TroubleshootSolution>
    <Steps>
      <Step title="Make sure you have the right runtime selected" icon={<Icon icon="check" iconType="regular" />}>
        The default `anaconda-<YEAR>.<MONTH>-py<PYTHON_VERSION>` runtimes have a broad selection of packages, but you might have created a custom environment for your notebook. Separate environments are represented as "runtimes" in JupyterLab. You can view and switch between available runtimes by clicking the runtime name in the upper-right corner of the content pane.
      </Step>

      <Step title="List the packages available in an environment" icon={<Icon icon="check" iconType="regular" />}>
        If one of your imports is failing, start by verifying that the package is present in the runtime environment. You can view which packages are available in your current environment from the terminal by running `conda list`.

        To view packages in a specific environment, run `conda list --name <ENV_NAME>`.

        To see a list of available environments, run `conda info --envs`. An asterisk appears beside your current active environment.
      </Step>

      <Step title="Create a custom runtime" icon={<Icon icon="check" iconType="regular" />}>
        If none of the Anaconda provided environments contain the package(s) you need, create a [custom runtime](/tools/anaconda-notebooks/notebook-runtimes#creating-custom-runtimes) for your notebook project.
      </Step>
    </Steps>
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### "Missing ipykernel dependency" error
  </TroubleshootTitle>

  <TroubleshootCause>
    A `missing ipykernel dependency` error is caused by an environment dependency list not including the required `ipykernel` package.
  </TroubleshootCause>

  <TroubleshootSolution>
    To resolve this issue, add the `ipykernel` package to your environment's dependency list. For example:

    ```yml highlight {7} theme={null}
        channels:
        - defaults
        dependencies:
        - python=3.11
        - numpy
        - pandas
        - ipykernel
    ```
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### Custom runtime not appearing in Launcher or Assign a Runtime modal
  </TroubleshootTitle>

  <TroubleshootCause>
    The most common reason a runtime or environment is not appearing in the Launcher or Assign a Runtime modal is that it doesn't contain a <Tooltip tip="A kernel is a programming-language-specific process that interprets your code, runs it, and gives you the results. For example, the `ipykernel` package enables interactive computing in Python.">kernel package</Tooltip>.
  </TroubleshootCause>

  <TroubleshootSolution>
    For more information and instructions on installing a kernel package in your runtime/environment, see [Creating custom runtimes](/tools/anaconda-notebooks/notebook-runtimes#creating-custom-runtimes).
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### "File load error," "unhandled error," or "unexpected error" message
  </TroubleshootTitle>

  <TroubleshootCause>
    If you receive a "file load error," "unhandled error," or "unexpected error," like in the following figure, you have most likely exceeded the storage space for your current plan.<br /><br />

    <Frame>
      <img src="https://mintcdn.com/anaconda-29683c67/q5KdI2mr6ZKMYRZp/images/notebook-quota-error.png?fit=max&auto=format&n=q5KdI2mr6ZKMYRZp&q=85&s=9beaf78e21e942a9d7d679d122f85b05" alt="" width="1022" height="410" data-path="images/notebook-quota-error.png" />
    </Frame>
  </TroubleshootCause>

  <TroubleshootSolution>
    Follow the steps in the storage question above to remove items from your Notebooks instance, or upgrade to a higher subscription plan.
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### Notebooks won't open from Anaconda Platform
  </TroubleshootTitle>

  <TroubleshootCause>
    Your browser's pop-up blocker (automatically enabled on Firefox and Safari) can prevent Notebooks from opening.
  </TroubleshootCause>

  <TroubleshootSolution>
    Disable your pop-up blocker and try opening Notebooks again from Anaconda Platform.
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### Notebook cannot access external sites after subscription upgrade
  </TroubleshootTitle>

  <TroubleshootCause>
    Notebook kernels inherit network permissions when a session is started. Any notebook sessions that were started while your account was using the Free plan are still operating under PythonAnywhere's [allowlist](https://www.pythonanywhere.com/whitelist/) restrictions.
  </TroubleshootCause>

  <TroubleshootSolution>
    Stop and restart all Notebook sessions to establish a kernel with unrestricted internet access.

    <Note>
      It can take up to an hour for the upgrade to take effect.
    </Note>
  </TroubleshootSolution>
</Troubleshoot>