xtls/xray-install

Easiest way to install & upgrade Xray

View on GitHub ↗Jump to charts ↓

Summary Information

Updated 24 minutes ago
Added to GitGenius on September 19th, 2026
Created on November 11th, 2020
Open Issues & Pull Requests: 36 (+0)
GitHub issues: Enabled
Number of forks: 654
Total Stargazers: 3,572 (+0)
Total Subscribers: 38 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 1.0 hours
Mean response time: 62.0 days
90th percentile: 251.1 days
Tracked items: 9

Most active contributors

Sign in to see contributor activity.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 9
New in 7 days: 0
Closed in 7 days: 0
Avg open age: 539 days
Stale 30+ days: 9
Stale 90+ days: 9

Recent activity

Opened in 7 days: 0
Closed in 7 days: 0
Comments in 7 days: 0
Events in 7 days: 0

Top labels

No label distribution available yet.

Most active issues this week

No issue events were indexed in the last 7 days.

Detailed Description

Xray-install is a Bash script that automates installation and upgrades of Xray on Linux systems.

The tool solves the problem of deploying Xray across different Linux distributions by providing a single installation script that handles systemd-based systems including CentOS, Debian, and OpenSUSE. It manages the installation of Xray-core binaries, geodata files (geoip.dat and geosite.dat), and systemd service configuration. The script supports both standard Linux distributions and Alpine or Gentoo Linux through separate OpenRC-specific installation paths. Users can perform basic operations like installing, upgrading, and removing Xray, with options to update only geodata files or to preserve configuration during removal.

Developers should choose this tool if they need to deploy Xray across multiple Linux systems without manually handling binary downloads, service file creation, and configuration management. It suits environments where systemd is available, or Alpine and Gentoo systems using OpenRC. The script offers flexibility through command options that control whether to use root or unprivileged user accounts, whether to include geodata updates, whether to install pre-release versions, and whether to configure log rotation.

The project shows consistent maintenance with regular updates to support new Xray releases and geodata versions. Development activity indicates active engagement with user needs through support for multiple Linux distributions and initialization systems. The maintainers have established clear documentation in multiple languages and provide specialized installation paths for less common distributions, demonstrating attention to edge cases beyond the most popular platforms.