Troubleshooting

The guide shows common errors that might occur when using Amazon SageMaker Studio Lab. Each error contains a description, as well as a solution to the error.

Can’t access account

If you can’t access your account, verify that you are using the correct email and password. If you have forgotten your password, use the following steps to reset your password. If you still cannot access your account, you must request and register for a new account using the instructions in Onboard to Amazon SageMaker Studio Lab.

Forgot password

If you forget your password, you must reset it using the following steps.

Can't launch project runtime

If the Studio Lab project runtime does not launch, try launching it again. If this doesn't work, switch the instance type from CPU to GPU (or in reverse). For more information, see Change your compute type.

Runtime stopped running unexpectedly

If there is an issue with the environment used to run JupyterLab, then Studio Lab will automatically recreate the environment. Studio Lab does not support manual activation of this process.

Conflicting versions

Because you can add packages and modify your environment as needed, you may run into conflicts between packages in your environment. If there are conflicts between packages in your environment, you must remove the conflicting package.

Environment build fails

When you build an environment from a YAML file, a package-version conflict or file issue might cause a build to fail. To resolve this, remove the environment by running the following command. Do this before attempting to build it again.

conda remove --name <YOUR_ENVIRONMENT> --all

Error message about allowing to download script from domain *.awswaf.com

Studio Classic uses the web application firewall service Amazon WAF to protect your resources, which uses JavaScript. If you are using a browser security plugin that prevents JavaScript from downloading, this error may pop up. To use Studio Classic, allow the JavaScript download from *.awswaf.com as a trusted domain. For more information on Amazon WAF, see Amazon WAF from the Amazon WAF, Amazon Firewall Manager, and Amazon Shield Advanced. Developer Guide.

Disk space is full

If you run into a notification saying mentioning that your disk space is full or File Load Error for <FILE_NAME> while attempting to open a file, you can remove files, directories, libraries, or environments to increase space. For more information on managing your libraries and environments, see Manage your environment.

Project runtime is in safe mode notification

If you run into a notification that Project runtime is in safe mode, you must free up some disk space to resume using the Studio Lab project runtime. Follow the instructions in the preceding troubleshoot item, Disk space is full. Once up to at least 500 MB of space has been cleared, you may restart the project runtime to use Studio Lab. This can be done by choosing Amazon SageMaker Studio Lab in the top menu of Studio Lab and choosing Restart JupyterLab....

git Cannot import cv2

If you run into an error when importing cv2 after installing opencv-python, you must uninstall opencv-python and install opencv-python-headless as follows.

%pip uninstall opencv-python --yes
%pip install opencv-python-headless

You can then import cv2 as expected.

Studio Lab becomes unresponsive when opening large files

The Studio Lab IDE may fail to render when large files are opened, resulting in blocked access to Studio Lab resources. To resolve this, reset the Studio Lab workspace using the following procedure.