3x-ui Offline Installer Builder is a high-performance, resilient tool designed to build fully self-contained installation bundles for the 3x-ui panel, specifically for air-gapped and restricted network environments.

🇮🇷 Read in Persian (فارسی) 🇮🇷

This tool eliminates the need for internet access on target servers by pre-packaging everything—from system dependencies (.deb, .rpm, .apk) to the panel binaries and SSL certificates—into a single, executable shell script.

• 🧠 Smart Update Engine: Detects existing installations and offers safe updates (preserving DB/users) or clean reinstalls.
• 🌐 Multi-Repo Discovery: Intelligent scraping of multiple streams (BaseOS/AppStream) for RHEL-based resilience.
• 🔄 Infinite Network Resilience: Bullet-proof downloader that continuously retries partial downloads instead of failing, ensuring successful bundling even on highly unstable or restricted networks.
• 🔒 Advanced SSL Management:
  • Automated Self-Signed generation with Dynamic mode (defer generation to target server to match its IP automatically).
  • Built-in Let's Encrypt DNS-01 Challenge (Generates trusted certs natively utilizing DoH over SOCKS5/HTTP proxy).
  • Custom certificate bundling.

Get the latest pre-built binary for your operating system from the Releases Page.

Execute the builder on a machine with internet access.

Linux / macOS:

chmod +x xui-offline-builder
./xui-offline-builder

Windows: Double-click xui-offline-builder-windows.exe or run via PowerShell:

.\xui-offline-builder-windows.exe

Transfer the generated bundle to your target server. The output will be a single .sh file (the name depends on the bundle name you chose during the wizard).

# Run on the target server (No internet required)
bash YOUR_BUNDLE_NAME.sh

If you find this project useful, please consider donating to support development and server costs.

This project is licensed under the GPLv3 License.