Exporting applications
You can export applications to be used outside of Nuvolos
Nuvolos features application exports to enhance user productivity, scientific openness and collaboration. This enables you to reuse your existing Nuvolos applications outside the platform for a wide range of use cases:
students experimenting with code of an old course on their own machines
authors sharing applications for the peer-review process of their papers and long-term archival
researchers running applications across multiple infrastructures (e.g. HPC clusters)
The export feature allows users to export eligible applications as public Docker images hosted on DockerHub. These images can run on any infrastructure that supports Docker containers, from desktop computers to compute clusters.
Some Nuvolos applications have licensing or technological restrictions that prevent export. If you believe your application should be eligible for export, please contact us on Intercom.
Starting the export process
Navigate to the space containing the instance where you want to export the application.
Navigate to the instance containing the application.
Make sure you are in the Current state.
On the sidebar click the Screen button (Applications), which shows you the Application list.
On the row of the application of interest, click ... under Actions.
In the drop-down click EXPORT APPLICATION.
Clicking this option opens a dialog where you can name (tag) your Docker image (you can only customize the final part of the image tag—the system automatically generates the rest to avoid collisions). You can also control whether Workspace files are included in the Docker image:
Your application will be exported to a public Docker image hosted on DockerHub. Anyone can use your image without authentication. Do not store sensitive data in your application's library area, as it will be included in the exported image. The same applies to Workspace files if you opt to export them too.
Contents of an exported image
An exported Nuvolos application image contains the following data:
Your application configuration, including installed packages and extensions stored in the APP LIBRARY area
A default startup command to launch the application executable
Workspace files, unless you opt out at image creation
Exported images do not contain:
Files from your HOME area (unix home folder), unless workspace files are also exported.
Managing exports
Navigate to the space containing the instance.
Navigate to the instance containing the application.
Make sure you are in the Current state.
On the sidebar click the Screen button (Applications), which shows you the Application list.
On the top left, click EXPORTED APPLICATIONS.
This takes you to the Exported applications screen.
In the Exported applications screen, you can review all your exported and currently exporting images and delete them when you no longer want them accessible.
Applications in the process of being exported are shown as In progress in the Status column.
Applications currently available are shown as Successful in the Status column.
Applications exported, but then removed show up as Deleted in the Status column. This refers to the status of the exported image, not the application on Nuvolos itself.
You can delete an existing export by hovering on the export in question and clicking on the trash icon under Actions.
Running the exported image
You only need a container runtime environment to run the exported images. If you're unfamiliar with container runtimes, we recommend to install Docker Desktop:
Nuvolos exports applications as standard Docker images. On machines with a Docker runtime and internet access, you can use the start command provided in the actions column on the exports screen.
To run the application locally:
Navigate to the space containing the instance.
Navigate to the instance containing the application.
Make sure you are in the Current state.
On the sidebar click the Screen button (Applications), which shows you the Application list.
On the top left, click EXPORTED APPLICATIONS.
This takes you to the Exported applications screen.
Locate the application image you want to run.
In the Actions column, click the copy to clipboard icon to get the docker command.
The command will have the following structure:
If the docker image isn't present locally, this command will automatically pull it from DockerHub and run it. Access your application by connecting to port 8888 on your machine in the browser:
Archiving your image
You may want to back up or archive your images outside of DockerHub. We recommend pulling the image using Docker, then saving it as an archive:
Load the archived image back using the load command:
Last updated
Was this helpful?