Application Overview
Application Definition
In abcdesktop.io, an application is an OCI-compliant container image. abcdesktop.io uses the OCI Image Specification to describe and manage application images. The docker inspect command exports the full OCI JSON metadata for a given image:
docker inspect $YOUR_IMAGE_NAME > file.json
abcdesktop.io-compatible images must include a set of well-defined OCI labels. These labels are read by the pyos control plane to register, classify, and launch the application. Example labels:
LABEL oc.icon="firefox.svg"
LABEL oc.keyword="firefox,mozilla,internet"
LABEL oc.cat="office"
LABEL oc.launch="Navigator.Firefox"
LABEL oc.name="Firefox"
LABEL oc.path="/usr/bin/firefox"
LABEL oc.type=app
Installing Applications
Multiple installation methods are supported to accommodate different deployment workflows:
- Use the default installation script: bash script
- Use the Admin Web UI console: Admin Console
- Submit a REST API request using
curlto POST the OCI JSON metadata to the API service
Replace
ABCDESKTOP_URL,ABCDESKTOP_PORT, andfile.jsonwith values appropriate for your deployment.
ABCDESKTOP_URL=localhost
ABCDESKTOP_PORT=30443
URL="http://$ABCDESKTOP_URL:$ABCDESKTOP_PORT/API/manager/image"
curl -X POST -H 'Content-Type: text/javascript' "$URL" -d "@file.json"
Default Application Repository
abcdesktop.io provides a curated set of default application images. These images are published in the abcdesktop images repository, along with the corresponding json metadata files and Dockerfile build definitions.
All default images support the Remote Browser Isolation (RBI) and Remote Application Isolation (RAI) model: each application runs as a dedicated, isolated container, and only the rendered graphical output is streamed to the client.
Application Catalog
The application catalog lists the application images available for abcdesktop.io. It covers a range of use cases, including office work, development, graphics, education, games, and utilities.
For each application, the catalog links to its Dockerfile and JSON image descriptor. The Dockerfile can be used to rebuild the image; the JSON descriptor contains the OCI metadata used to install and configure it. The table also shows the image tag, category, container engine when applicable, desktop entry, display name, access control, rules, visibility, and base template. These details help administrators select an image and understand how it is presented and run in the desktop.
Use the catalog's JSON descriptor with the installation script or the Admin Web UI console. The catalog links to the abcdesktop images repository, where the image build definitions and artifacts are maintained.
Example: Firefox Application JSON Descriptor
The following is an example of a firefox.d.4.4.json OCI image descriptor file, as generated by docker inspect:
[
{
"Id": "sha256:09895c74c9e5252f3eef74db878cbd6399cd1f26314d46e3f5aa589022e3d26e",
"RepoTags": [
"ghcr.io/abcdesktopio/firefox.d:4.4"
],
"RepoDigests": [
"ghcr.io/abcdesktopio/firefox.d@sha256:d4cce0dbe65f7cbf6fb70528d1df54f2e2ae40df373ac1fa2ef7e8a0d96d8b99"
],
"Parent": "",
"Comment": "buildkit.dockerfile.v0",
"Created": "2026-02-28T11:36:41.181120224Z",
"DockerVersion": "",
"Author": "",
"Config": {
"Env": [
"PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
"DEBCONF_FRONTEND=noninteractive",
"TERM=linux",
"NODE_MAJOR=24",
"LANG=en_US.utf8",
"ARGS=--no-remote",
"APPNAME=Firefox",
"APPBIN=/usr/bin/firefox",
"APP=/usr/bin/firefox"
],
"Labels": {
"oc.acl": "{\"permit\":[\"all\"]}",
"oc.args": "--no-remote",
"oc.cat": "office",
"oc.desktopfile": "firefox.desktop",
"oc.displayname": "Firefox (ubuntu)",
"oc.fileextensions": "htm;html;xml;gif",
"oc.icon": "circle_firefox.svg",
"oc.keyword": "firefox,firefox,mozilla,web,internet",
"oc.launch": "Navigator.firefox",
"oc.legacyfileextensions": "htm;html;xml",
"oc.mimetype": "text/html;text/xml;application/xhtml+xml;application/xml;application/rss+xml;application/rdf+xml;x-scheme-handler/http;x-scheme-handler/https;x-scheme-handler/ftp;video/webm;application/x-xpinstall;",
"oc.name": "Firefox",
"oc.path": "/usr/bin/firefox",
"oc.rules": "{\"homedir\":{\"default\":true}}",
"oc.secrets_requirement": "[\"ntlm\",\"kerberos\"]",
"oc.showinview": "dock",
"oc.type": "app"
}
},
"Architecture": "amd64",
"Os": "linux"
}
]