CoCalc Cloud 2.8.1#


These pages were created for version 2.8.1-0300f57 as of May 12, 2023.

Welcome to CoCalc Cloud!#

CoCalc Cloud is a simplified and streamlined on-premises variant of CoCalc, which you can install on your own cluster. It offers the same powerful features as the online version and inherits the same reliable, scalable performance our online platform is known for.

This version is designed specifically for companies and universities with their own computing infrastructure, providing scalability and full support for thousands of users. CoCalc Cloud covers additional privacy requirements and provides complete infrastructure control, with the ability to customize the platform to meet your specific needs.

We are proud to have developed CoCalc Cloud using the knowledge we’ve gained from running on Kubernetes since 2014.


If you are reading this online, you only see the generated documentation. The code and configuration files are proprietary and not available to the public.

If you are interested in CoCalc Cloud, please contact Sagemath, Inc..


  • Jupyter Notebooks: provide access to recent versions of Sage, Python 3, R, and Octave.

  • Like with the online version of CoCalc, users can edit both code and text files, compile LaTeX documents, use a Linux terminal, compile code, and utilize a virtual X11 desktop, etc.

  • Installed software: there are various ways you can extend, adapt or even replace the standard software environments to meet specific requirements.

  • Support for single sign-on authentication, in particular SAML.

  • Networking is defined by standard Ingress rules. It is also possible to run within a VPN.

  • You can deploy this solution on your own bare-metal cluster; managed clusters like Amazon’s AWS EKS or Google’s GCE GKE and other options should work as well.

Table of Contents#

  • Architecture – a high-level overview of the architecture of CoCalc Cloud.

  • Setup – this is what you need to have in place in order to deploy CoCalc Cloud.

  • Deployment – this is the main step, deploying CoCalc Cloud via HELM.

  • Operations – notes about running CoCalc, and how to enable the “Prepull” service.

Public Cloud Providers#

  • Google GCP – some configs and notes about running on an GKE cluster.

  • Amazon AWS – notes about running on an AWS EKS cluster.