CoCalc: Backend webserver component
npm install @cocalc/hubThis code is part of https://github.com/sagemathinc/cocalc and isn't currently designed to be used standalone. Our plan is to refactor this code into smaller useful modules that are published under the @cocalc npm organization.
This is a node.js process that serves _all_ of the following (possibly simultaneously):
- static content - our mirror of the cdn and the results of webpack (packages/static)
- an http api as documented at https://doc.cocalc.com/api
- a websocket connection that client browsers use for sign in, account config, creating projects, etc.
- a proxy server that connects client browsers to projects
- project control server that creates, starts and stops projects running locally
Run the dev server, suitable for use inside a CoCalc project:
``sh`
npm run hub-project-dev
Just set either the BASE\_PATH or PORT environment variables when starting thehub, and it will use what you set. If you do not set a BASE\_PATH it uses either"/" by default, or something involving the project id if you're inside a CoCalcproject.
If you don't set the PORT then 5000 is used by default. The only way to set the port is via the PORT environment variable.
You can use the --hostname command line options if you are starting the hub directly via the cocalc-hub-server script and need to specify a different interface (e.g., 0.0.0.0 instead of localhost).
As a quick test, you can do
`sh`
openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout ./selfsigned.key -out selfsigned.crt
to create self-signed key and cert. You can then start the hub with these two files as options:
`sh``
cd packages/hub; npx cocalc-hub-server ... --https-key=./selfsigned.key --https-cert=./selfsigned.crt
and the hub will use https instead of http. Simple as that.