45 lines
1.7 KiB
Markdown
45 lines
1.7 KiB
Markdown
# LXS
|
|
|
|
Linux multi-tool — a Bash menu and CLI for installing common server apps and running system tools on Debian/Ubuntu.
|
|
|
|
## Quick install
|
|
|
|
```bash
|
|
curl -fsSL https://git.hyko.cx/hykocx/lxs/raw/branch/main/lxs.sh | sudo bash -s -- setup
|
|
```
|
|
|
|
This downloads the repo tarball, installs every file to `/usr/local/share/lxs/`, and creates the symlink `/usr/local/bin/lxs`. After install, sub-scripts run from disk — no network calls per command.
|
|
|
|
> Avoid `sudo bash <(curl …)` — process substitution opens `/dev/fd/63` in your shell, which the root `bash` spawned by `sudo` cannot read (`bash: /dev/fd/63: No such file or directory`). Pipe through `sudo bash -s --` instead.
|
|
|
|
Or run once without installing (no `sudo` needed for the entrypoint — sub-scripts auto-elevate when they need root):
|
|
|
|
```bash
|
|
curl -fsSL https://git.hyko.cx/hykocx/lxs/raw/branch/main/lxs.sh | bash
|
|
```
|
|
|
|
When a new version is published in this repo, the interactive menu shows a *"Nouvelle version disponible"* banner; run `lxs update` to pull all updated files.
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
lxs # Interactive menu (checks for updates, cached 24h)
|
|
lxs setup # First-time install of all files to /usr/local/share/lxs
|
|
lxs update # Update all installed files to latest
|
|
lxs install <app> # Install an application
|
|
lxs tool <name> [args] # Run a system tool
|
|
lxs info # Show system info
|
|
lxs version # Show version
|
|
lxs help # Show help
|
|
```
|
|
|
|
## Requirements
|
|
|
|
- Debian or Ubuntu (other distros may work but are not tested)
|
|
- `curl`
|
|
- Some sub-scripts require root; they will auto-elevate via `sudo` when run.
|
|
|
|
## License
|
|
|
|
MIT
|