Skip to content

An app is software that projectEureka can start on a machine, usually a container image (SIF) run with Apptainer. Admins add apps here. Project Editors and Owners then wrap an app in a launcher (app, instance type, and options) so members can start it with one click, or use the app in a flow stage.

  • You must be a System admin.
  • For a container app, the image must be in Library or downloadable from Catalog.

App Administration has three tabs:

  • Apps: apps on this environment. While the list loads, the page shows Loading apps…. If there are none, it then shows No apps yet. Select New App. The New Container App window opens. Fill in the fields below and select Create. Edit on a row opens Container App Settings, where you select Update App. Delete removes the app.

  • Library: container images (SIFs) already on this environment. Select Create app on a row to start a new app from that SIF.

  • Catalog: apps available to download. Refresh updates the list.

    The catalog is one public catalog run by Omnibond, at https://containers.projecteureka.ai, for every environment. Downloads from it are anonymous HTTPS. You do not create a catalog bucket, grant access to one, or add a key. If a download fails, check that the login node can reach that address. Your own buckets are separate and still need credentials.

On Library and Catalog, filter by use: launchers (Launch), flows (Flow), or All uses.

Google Cloud

App Administration with the Apps, Library, and Catalog tabs and the New App button

Google Cloud

New Container App window with Display Name, Container Image / FilePath, App Connect Path, Container Arguments, Host Image, Binds, and Environment
Field Meaning
Display Name The name people see on launchers.
Container Image / FilePath The SIF container image on this environment, for example /vault/containers/<name>/<version>/image.sif.
App Connect Path For a web app, the path the browser opens, such as /login (or rnode:/login). Leave it blank for a desktop app such as QGIS or ParaView: the session then connects over VNC.
Container Arguments Optional arguments passed to apptainer exec.
Host Image The machine image the session’s virtual machine boots from. Default uses the environment’s default image.
Binds Optional. Folders mounted into the container, one host:container pair per line. The host path must be under $SCRATCH, $HOME, or /tmp. Create app fills this from the Library entry.
Environment Optional. One KEY=value per line. $SCRATCH, $PORT, and $PASSWORD are expanded.
Launch config Optional JSON object written to $SCRATCH/launch.json for the app’s start script. A launcher can override these keys.

Add an app (launcher) · Manage launchers