Every recipe in the Linxr Marketplace is a small JSON object. This part shows how to use the Marketplace, how to make your own recipe, and how to publish it so every Linxr user can install it.

1️⃣ Install a recipe

  1. Start the VM on the Home tab.
  2. Open Marketplace and tap ↻ Refresh to sync community recipes.
  3. Filter by Docker or Native, pick a recipe and tap Deploy.
  4. Open the app in Chrome on your phone at http://localhost:<port>, for example 8080.

2️⃣ Make your own, on the phone

The Marketplace has a custom recipe builder. Choose a type:

  • docker: an image and its ports
  • script: an install script that runs inside Alpine

Save it, or import a recipe JSON someone sent you. To share yours, publish it to the marketplace repo (step 4).

3️⃣ The recipe format

A Docker recipe:

{ "id": "caddy", "name": "Caddy Web Server", "category": "Web & Cloud", "type": "docker", "author": "Caddy Authors", "version": "2-alpine", "iconCodePoint": 58125, "image": "caddy:2-alpine", "ports": [{ "host": 8080, "container": 80 }], "description": "Fast, multi-platform web server with automatic HTTPS.", "notes": "Access Caddy at http://localhost:8080 in Chrome on your device.", "isCustom": false }

A script recipe swaps image and ports for a script:

{ "id": "neofetch", "name": "Neofetch & CLI Tools", "category": "Utilities", "type": "script", "author": "Community", "version": "latest", "iconCodePoint": 59048, "description": "Installs neofetch, htop, and tree for command-line diagnostics.", "script": "apk update && apk add --no-cache neofetch htop tree", "notes": "Run 'neofetch' in the Terminal tab to display system specs.", "isCustom": false }

Categories in use today: Kubernetes & DevOps, Dev Environments, AI & ML, Web & Cloud, Databases, IoT & Network, and Utilities.

4️⃣ Publish it for everyone

  1. Fork AI2TH/linxr-marketplace.
  2. Add your entry to recipes.json.
  3. Check it locally: 
 node validate.js
  1. Open a pull request. CI validates the JSON, the schema and the port bindings.

Once it is merged, every Linxr user gets your recipe on their next Refresh, with no app update.

💡 Recipe ideas we would love to see

A Matrix or XMPP server, Home Assistant, a Gitea instance, MQTT brokers for IoT tinkering, or your favourite dev environment. If it runs on Alpine or in an arm64 container, it can be a recipe.

📥 Get Linxr