Share helps teams collaborate in reproducible workspace environments. Team members can contribute to a project using the same environment (on any OS), knowing that all behaviors will match on every developer’s machine.

Sharing Workspaces

Export to File

In the user dashboard’s workspace detail view for a specific workspace:

  1. Click the “Export As A File” button to bring up the Export Workspace window. A custom recipe for the workspace will be shown. It includes environment and project information for the workspace.
  2. Click “Download” or “Copy to Clipboard” to get a copy of the workspace JSON which can be imported into another instance.

To import the JSON in another instance: f

  1. Ensure that the two instances are running the same version.
  2. In the user dashboard select “Workspaces” from the left navigation bar.
  3. Click “Add Workspace”.
  4. Under “Select Source” choose “Import an existing workspace configuration”.
  5. Paste the JSON in the text editing area.


Share with Factories includes “Factories” - templates used to generate new or open existing workspaces with a URL. Factories can be used to clone existing workspaces or repeatedly generate consistent workspaces for teams.

You can replicate a workspace by creating such a factory. There are two ways to create a workspace:

1. Within the running IDE

The easiest way to create a factory is by going to Workspace -> Create Factory from within the main menu of the IDE in a running workspace.

workspace create factory

You can set a name for the factory and click on Create to generate the factory. The Factory URL will be displayed in the field underneath. Next to it you can either start or further configure it.

factory dialog

2. Via the Dashboard

You can also create a factory through the Dashboard by clicking on Factories -> Create Factory. Next you will see a list of your workspaces. You can select one and click the Create button on the bottom of the page to start the factory creation.

dashboard create factory

After clicking Create, the factory is already created and the URLs are displayed on the top of the page.

The following configuration dialog allows you to specify various parameters of the factory, but you can leave the defaults if you like. It allows you to configure the stack to be used and the amount of RAM the workspace should have (note that free accounts are limited to 2GB even though you can select more). Run commands might be handy to trigger specific build actions. On the bottom you will see the compete configuration as a JSON file.

config factory


A factory does not replicate your file system within the workspace. It replicates the stack (usually silexica/tools:latest), all set up projects (typically imported via git or github) and all run configurations.


  • if you have installed software via apt-get or other means, it will not be included in the factory. To include those as well, you need to create a custom stack.
  • if you have changed files after importing a project via git, make sure these files are committed to your repository. Otherwise they will not be included in the factory.

Creating a Custom Stack

To install additional software within a workspace or a factory, you need to create a custom stack. The details are described in Runtime Recipes.