Skip to content

Install a TurnKey Appliance

The Catalog tab is a curated marketplace built on TurnKey Linux — pre-baked container images for common services (WordPress, GitLab, Nextcloud, etc.). Picking an appliance imports its LXD image — it doesn't create a running container for you; you still create the container yourself afterward, same as any manually pulled image.

How it works

Each catalog entry maps to a TurnKey appliance slug. Clicking Install:

  1. Downloads the image from the single TurnKey mirror, mirror.turnkeylinux.org (plain HTTP — its HTTPS cert doesn't validate; there's no Canonical/Proxmox mirror in the path — Proxmox's own CDN doesn't redistribute the TurnKey LXC builds).
  2. Imports it into LXD as turnkey-<slug>.

The first import of an appliance pulls the image (~150–400 MB); a second import of the same appliance on the same node is much faster since LXD already has it cached.

Quick steps

  1. Catalog tab.
  2. Find the appliance — filter by category (Web, CMS, DevOps, Storage, Database, Network, Education, E-commerce, Media, Communication).
  3. Click the card → Install. This only imports the image.
  4. Once it finishes, use Create a Container and pick the imported turnkey-<slug> image — same as any manually pulled image.

Available appliances

Category Examples
Web lamp, lapp, nginx-php-fastcgi, nodejs, django
CMS wordpress, drupal10, joomla4, mediawiki, bookstack
DevOps gitlab, gitea, jenkins, mattermost, redmine, bugzilla, ansible
Storage nextcloud, owncloud, fileserver
Database mysql, postgresql, redis, couchdb
Network openvpn, domain-controller, observium
Education moodle, canvas
E-commerce prestashop, opencart, bagisto
Media zoneminder, mediaserver, avideo
Communication mumble

The catalog is hand-curated (not scraped from the mirror), so slugs are checked against real files at mirror.turnkeylinux.org/turnkeylinux/images/proxmox-15.0/ before being added — if an appliance you want isn't listed, it may still be pullable manually via Pull an LXD Image if the mirror has it.

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 you create it to step through it. Some appliances (LAMP, nginx) skip the wizard — they're ready out of the box.

See also