framework-install is the LGF governed platform installer. It installs new benches, syncs platform libraries, updates the framework payload, manages rollback, and updates the host reverse-proxy base domain.

General Usage

sudo framework-install --help

sudo framework-install --platform="<platform>" --help

sudo framework-install --library-sync --license-key="user:token"

sudo framework-install --update --license-key="user:token"

sudo framework-install --rollback=library --license-key="user:token"

sudo framework-install --rollback=framework --license-key="user:token"

sudo framework-install --update-domain-url="example.com"

Purpose

  • Use general help to view available platforms.
  • Use platform-specific help to view required install switches.
  • Use --library-sync to refresh installed platform libraries.
  • Use --update to refresh the full framework payload.
  • Use --rollback to restore the latest library or framework archive.
  • Use --update-domain-url to set or update the appliance reverse-proxy base domain.

Supported Platforms

  • atc
  • frappe
  • gitlab
  • meshcentral
  • nextcloud
  • ollama
  • openproject

Common Options

  • --platform=VALUE — Select target platform.
  • --license-key=VALUE — License / authority input.
  • --MSP-key=VALUE — Legacy alias for --license-key.
  • --bench=VALUE — Bench name under /opt/LGF/<bench>/.
  • --reverse-proxy=VALUE — Optional reverse-proxy-only ingress policy.
  • --release-object=FILE — Optional Release Object validation.
  • --domain-url=VALUE — One-time host reverse-proxy base domain set.
  • --update-domain-url=VALUE — Update host reverse-proxy base domain.
  • --library-sync — Refresh installed platform libraries only.
  • --update — Refresh installed framework payload only.
  • --rollback=library — Restore latest library archive.
  • --rollback=framework — Restore latest framework archive.

Platform Install Examples

ATC

ATC supports optional URL, listen port, and reverse proxy fields.

sudo framework-install --platform="atc" --bench="lgf-atc01" --license-key="user:token"

Frappe

Frappe requires an admin password and supports URL, listen port, ERP assets version, protocol, database password, SSL certificate path, reverse proxy, and related flags.

sudo framework-install --platform="frappe" --bench="erp01" --license-key="user:token" --admin-pass="change-me" --url-internal-only

GitLab

GitLab requires an admin password and supports URL, listen port, reverse proxy, SSH port, image override, and optional internal LGF repo seeding.

sudo framework-install --platform="gitlab" --bench="gitlab01" --license-key="user:token" --admin-pass="change-me"

MeshCentral

MeshCentral supports URL, listen port, and reverse proxy configuration.

sudo framework-install --platform="meshcentral" --bench="mesh01" --license-key="user:token"

Nextcloud

Nextcloud requires an admin password and platform version, and supports URL, listen port, reverse proxy, storage mode, remote storage fields, SMB/CIFS credentials, and storage salvage.

sudo framework-install --platform="nextcloud" --bench="cloud01" --license-key="user:token" --admin-pass="change-me" --nc-version="v202604"

Ollama / OpenWebUI

Ollama supports stack mode, URL, listen port, protocol, model selection, remote Ollama URL, API allowlist, image overrides, GPU acceleration, hybrid GPU mode, and reverse proxy.

sudo framework-install --platform="ollama" --bench="ai01" --license-key="user:token" --stack-mode="openwebui+ollama"

OpenProject

OpenProject requires an admin password and supports platform version, URL, listen port, and reverse proxy configuration.

sudo framework-install --platform="openproject" --bench="op01" --license-key="user:token" --admin-pass="change-me"

Important Notes

  • framework-install creates and applies benches.
  • Use platform help before installing a platform.
  • Flux is not included in the release documentation.
  • Library sync and framework update do not modify existing benches directly.