mirror of
https://github.com/MHSanaei/3x-ui.git
synced 2026-06-28 00:24:19 +00:00
MHSanaei
30796dc2ce
Remove the release-driven Packer AMI/qcow2 pipeline and everything that existed only to feed it: the image.yml workflow, deploy/packer, deploy/lightsail, deploy/firstboot, the AWS Marketplace checklist, and the first-boot smoke test/job. Keep the cloud-agnostic unattended-install path (cloud-init + install.sh non-interactive) and the Hetzner notes, which never depended on the workflow. Hetzner's snapshot path is dropped too since it relied on firstboot to avoid admin/admin on clones; cloud-init regenerates per-instance credentials on its own. Update deploy/README, the cloud-init and Hetzner docs, the root README plus its six translations, and .gitattributes to match.
32 lines
1.4 KiB
Markdown
32 lines
1.4 KiB
Markdown
# 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/`](cloud-init/) | Generic cloud-init user-data (unattended `install.sh`) | Any cloud, no image build |
|
|
| [`marketplace/hetzner/`](marketplace/hetzner/) | Hetzner Cloud notes | Hetzner deployments |
|
|
| [`test/`](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`](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).
|