Sharing Files

Make a file or directory publicly visible to the world.

Note

CoCalc’s share server is available at https://cocalc.com/share/

Publishing Files

You can make individual files and folders public. First, do either of the following:

• With the file open, click the lock icon at upper right. Note: if you see the bullhorn icon instead of the lock, that means your file is already shared; you could click it to change sharing settings.

click lock icon to enter file-sharing dialog

lock is replaced by bullhorn if file is already shared

• In the Files listing for your project, check the box in the leftmost column for your file, and click Share. You can also select more than one file in order to share them together (e.g. an HTML page that includes images)

After either of these steps, you can see the “Share” dialog. You may enter a description for the file being shared, then click Make item public and your file is shared.

In addition to the above settings, you may specify an optional public file name. Setting this name provides much nicer URL’s for shared public documents. See Vanity URLs below to learn more.

Vanity URLs

You can now make it so https://cocalc.com/name-of-your-choice  (e.g., https://cocalc.com/wstein) lists all of the documents you have shared publicly.

CoCalc lets you assign a username, project names, and file names, so that you can create links to shared files that are easy to type and remember.

• Set your username in Account Preferences.
• Set your project name in Project Settings.
• Set your file name as shown in Publishing Files.

If you set all these you get a nice url, e.g., https://cocalc.com/wstein/support/examples

View Your File on the Share Server

After clicking Make item public as above, the public URL will be displayed under Shared publicly. You can click the button to open it at the share server.

With that link, your file is available read-only on the CoCalc lightweight share server. A CoCalc login is not needed to access files on the share server. Files on the share server are indexed by Google unless you click the checkbox next to “Unlisted: Only allow those with a link to view this.”.

File-sharing Tips

• If your document depends on auxiliary files (e.g., images embedded in a markdown file) make sure these auxiliary files are also published. A convenient way to do this is to have auxiliary files in a common folder and share that folder.
• Serving raw files: you can host arbitrary html, etc. through the share server. Files can be viewed in “raw” form, i.e. without CoCalc controls, by opening in the share server and clicking “Raw” at upper right.
• Interactive elements that use server processes, such as notebooks with Jupyter widgets and worksheets with Sage @interact, will not operate in files viewed from the share server. That is because documents on the share server are truly static. There is no kernel or Sage server running in the background to facilitate any sort of interactive computing. Controls that run completely in the browser, for example in 3d plots like this cardiod, will work when served from the share server.

Note

If you would like to collaborate and chat with other people on documents in your project, go the Project Settings tab and “Add people to project”.