Limitations

This release of Google Cloud Shell has the following known limitations.

Custom installed software packages and persistence

The virtual machine instance that backs your Cloud Shell session is not permanently allocated to a Cloud Shell session and terminates if the session is inactive for an hour. After the instance is terminated, any modifications that you made to it outside your $HOME are lost.

.bashrc content

Cloud Shell may produce errors if the .bashrc file is modified or deleted. It should at least contain the following:

  if [ -f "/google/devshell/bashrc.google" ]; then
    source "/google/devshell/bashrc.google"
  fi

Slow connection performance

Connecting to a Cloud Shell for the very first time involves creating your home disk and can currently take up to 25 seconds. Subsequent connections to existing virtual machine instances should take about five seconds.

Browser support

Cloud Shell supports the latest versions of Google Chrome, Mozilla Firefox, Microsoft Edge, Microsoft Internet Explorer 11+ and Apple Safari 8+. Safari in private browser mode is not supported.

Usage limits

Cloud Shell is intended for interactive use only. Non-interactive sessions will be ended automatically after a warning. Prolonged usage or computational or network intensive processes are not supported and may result in session termination without a warning.

If your session is terminated or cannot be established because you exceeded a service limit, Cloud Shell will display an error with a link to a form that allows you to appeal the limit violation. Click the feedback link and submit the form with more information about the tasks you were performing before your session was terminated.

If you do not access Cloud Shell regularly, we may recycle your home disk. You will receive an email notification before we do so and simply starting a session will prevent its removal. Please consider a different solution on Google Cloud Storage for sensitive data you wish to store long term.

Outgoing connections

Outgoing connections from Cloud Shell can only be made to the following TCP ports: 20, 21, 22, 80, 443, 2375, 2376, 3306, 8080, 9600, and 50051.

Resetting Cloud Shell to default state

To restore your Cloud Shell home directory to a clean state:

  1. Check for personal files in the home directory:
      ls -a $HOME
    
  2. Remove all files from your home directory:
      sudo rm -rf $HOME
    
  3. In the Cloud Shell menu, click the gear icon, then click Restart Cloud Shell. Click Restart Cloud Shell in the confirmation dialog.

A new VM will be provisioned and the home directory will be restored to its default state.

What's next

Monitor your resources on the go

Get the Google Cloud Console app to help you manage your projects.

Send feedback about...

Cloud Shell