Help Center/ ModelArts/ Model Development/ Using Notebook for AI Development and Debugging/ Using a Notebook Instance for AI Development Through JupyterLab/ Upgrading JupyterLab
Updated on 2026-05-29 GMT+08:00
View PDF
Share

Upgrading JupyterLab

To enhance the usability of notebook, JupyterLab has been upgraded to version 4.4.10 (stable version in 2025). This major leap from the 2021 legacy version (3.2.3) significantly optimizes performance and startup speed. Key improvements include a rebuilt editor, enhanced debugging and collaboration tools, a more stable ecosystem, and comprehensive refinements to the interactive experience and memory efficiency. Hope you enjoy the upgrade.

Notes

Support for creating new notebook instances using JupyterLab 3.2.3 will be discontinued in April 2026. Additionally, technical support, including updates for new features, vulnerability/issue fixes, patch upgrades, service ticket guidance, and online troubleshooting, will no longer be provided. These services will no longer be applicable to the O&M assurance of ModelArts. Therefore, upgrade to JupyterLab 4 to experience the latest features.

JupyterLab 4

This version has significantly improved user experience, functions, and performance. The following table lists the main updates. For more information, see JupyterLab Documentation.

Table 1 Feature updates

Function Module

Description

Workspaces

You can create multiple workspaces to organize and manage different projects and files, improving project management efficiency.

Launcher creation toolbar

Added a toolbar for function access and convenient operations.

Theme framework optimization

Optimized the theme framework to enhance the theme flexibility and compatibility. You can customize the GUI as required.

Configuration page optimization

Optimized user experience on the configuration page for easier use.

Performance optimization and debugging enhancement

Fully optimized the system performance and enhanced the debugging function to improve the development experience.

Code editor enhancement

Improved the code editor by adding new functions and optimizing performance to enhance the coding experience.

Search function enhancement

Enhanced the search function for quicker and more accurate search.

Performance enhancement

Improved the overall performance, system response speed, and system stability.

Custom CSS style sheets

Custom CSS style sheets can be used to adjust the GUI appearance to meet personalized requirements.

Markdown charts

Charts can be used in Markdown to facilitate document writing.

Virtual scroll bar

Introduced the virtual scroll bar to improve the scrolling experience of large files or a large amount of content.

Workspace UI

Improved the workspace UI to provide better visual effect and operation experience and enhance UI friendliness.

File access records

You can view recently opened and closed files to quickly access common files and improve work efficiency.

Keyboard shortcuts improvement

Keyboard shortcuts are improved for higher operation efficiency and convenience.

Method 1: Stopping a Notebook Instance and Upgrading JupyterLab

After a notebook is stopped, only the data stored in /home/ma-user/work is retained. To save the development environment, save its settings as an image. For details, see Method 2: Saving a Notebook Instance and Upgrading JupyterLab.

If your notebook uses EVS for storage, EVS billing per GB continues even after stopping the instance until you delete it. For details about the billing, see Billing Item > Development Environment.

  1. Stop the notebook instance.
    1. Log in to the ModelArts console. In the navigation pane on the left, choose Development Workspace > Notebook.
    2. On the Notebook page, click Stop in the Operation column of the target instance.
    3. In the displayed dialog box, read the message and click OK.

      When the status of the notebook instance is Stopped, the notebook instance has been stopped.

      Figure 1 Notebook instance status

  2. Upgrade JupyterLab.
    1. On the Notebook page, click Start in the Operation column of the stopped instance.
    2. In the displayed dialog box, select JupyterLab 4, configure Auto Stop, and click OK.
  3. Check whether JupyterLab is upgraded.

    On the Notebook page, click the instance name. If JupyterLab 4 is displayed on the instance details page, JupyterLab has been upgraded.

Method 2: Saving a Notebook Instance and Upgrading JupyterLab

After the image is saved, the default working directory is the root directory /. Any installed dependency packages will be retained in the saved image. However, content in persistent storage (the /home/ma-user/work directory) will not be included in the final container image. In VS Code remote development scenarios, plugins installed on the server side will also be retained.

  1. Save the image. For details, see Saving a Notebook Instance.
  2. Upgrade JupyterLab.
    1. In the navigation pane on the left, choose Asset Management > Image Management.
    2. In the Registered Images tab, click the name of the image saved in step 1.
    3. In the Operation column, click Create Notebook.
    4. On the displayed page, select JupyterLab 4, modify other parameters as required, and click Next.

      When the notebook instance is in the Running state, the notebook instance has been created.

  3. Check whether JupyterLab is upgraded.

    On the Notebook page, click the instance name. If JupyterLab 4 is displayed on the instance details page, JupyterLab has been upgraded.