3x-ui/deploy
2026-10-16 03:27:30 +08:00
..
cloud-init fix: keep panel and CLI updates on fork releases 2026-10-16 03:07:48 +08:00
marketplace/hetzner chore(deploy): drop the AWS golden-image build stack 2026-06-26 00:35:34 +02:00
test fix(release): rebuild Dev when packaged OpenRC unit changes 2026-10-16 03:27:30 +08:00
README.md chore(deploy): drop the AWS golden-image build stack 2026-06-26 00:35:34 +02:00
release-source.sh fix: keep panel and CLI updates on fork releases 2026-10-16 03:07:48 +08:00
sync-release-source.py fix: keep panel and CLI updates on fork releases 2026-10-16 03:07:48 +08:00

Cloud deployment (unattended install)

Tooling to ship the 3x-ui panel via unattended install, with per-instance credentials generated on first boot (never admin/admin, never a shared session secret). Works on amd64 and arm64.

Path What it is Use when
cloud-init/ Generic cloud-init user-data (unattended install.sh) Any cloud, no image build
marketplace/hetzner/ Hetzner Cloud notes Hetzner deployments
test/ Container smoke test Verifying the install path

How it works

install.sh runs unattended when XUI_NONINTERACTIVE=1 or stdin is not a TTY. Each instance installs and configures itself with random credentials. See cloud-init/README.md.

Unattended install knobs

install.sh reads these env vars in non-interactive mode (all optional; unset ⇒ secure random / default):

XUI_USERNAME, XUI_PASSWORD, XUI_PANEL_PORT, XUI_WEB_BASE_PATH, XUI_SSL_MODE (none|ip|domain, default none), XUI_DOMAIN, XUI_ACME_EMAIL, XUI_ACME_HTTP_PORT (ACME HTTP-01 listener port, default 80), XUI_SSL_IPV6 (optional IPv6 address to add to an ip-mode cert), XUI_SERVER_IP (fallback IP for the displayed access URL when auto-detection fails), XUI_DB_TYPE (sqlite|postgres), XUI_DB_DSN.

The resulting credentials are written to /etc/x-ui/install-result.env (mode 600).