Skip to content

Install a TurnKey Appliance

The Catalog tab is a one-click marketplace built on TurnKey Linux — pre-baked container images for common services (WordPress, GitLab, OpenLDAP, etc.). Pick an appliance, pick a host, click Deploy.

How it works

Each catalog entry maps to a TurnKey appliance name and version. MFCloud:

  1. Picks a working TurnKey mirror (Canonical → Proxmox CDN → mirror.turnkeylinux.org, with fallback if any 404s).
  2. Tries the latest version, then steps back through 18.2 → 18.1 → 18.0 → 17.1 if the mirror doesn't have the latest.
  3. Downloads the LXD image (Debian-prefixed filename format).
  4. Imports it into LXD as turnkey-<appliance>.
  5. Creates a container from that image with reasonable defaults (1 vCPU, 1 GB RAM, default pool).

The first deploy of an appliance pulls the image (~150–400 MB). Subsequent deploys of the same appliance on the same node start in under 20 s.

Quick steps

  1. Catalog tab.
  2. Find the appliance — search/filter by tag (LAMP, CMS, IDE, etc.).
  3. Click the card.
  4. Pick Host, name, and any optional credentials in the modal that opens.
  5. Install.

Available appliances

Category Examples
LAMP / Web lamp, nginx-php-fastcgi, lapp
CMS wordpress, drupal9, joomla4
Dev gitlab, gitea, redmine, phabricator
Identity openldap, keycloak
Data postgresql, mysql, redis, couchdb
Files nextcloud, seafile, mediaserver
E-commerce prestashop, opencart

(Removed entries that no longer exist on the TurnKey mirror: mongodb, mezzanine, magento, plex — they 404 even on the official site.)

First-boot credentials

TurnKey appliances run an interactive firstboot.d wizard the first time they start, asking for admin passwords, web admin email, etc. Open the Console action on the container right after deploy to step through it. Some appliances (LAMP, nginx) skip the wizard — they're ready out of the box.

See also