Readme update for version 1.0 (#225)
* Readme update for next version * update readme * link fix * language * more changes * typo * more cleanup --------- Co-authored-by: Meliox <na>
This commit is contained in:
parent
94a352ae34
commit
c1c26aff56
85
readme.md
85
readme.md
@ -3,11 +3,80 @@ A small collection of scripts and mods for Proxmox Virtual Environment (PVE)
|
|||||||
|
|
||||||
If you find this helpful, a small donation is appreciated, [](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=K8XPMSEBERH3W).
|
If you find this helpful, a small donation is appreciated, [](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=K8XPMSEBERH3W).
|
||||||
|
|
||||||
## Node sensor readings view
|
| Version | Description | Status |
|
||||||
|
|---------|-------------|--------|
|
||||||
|
| **v2** (current) | Debian package (`pve-mod`) with interactive `pve-mod-configure` wizard | Recommended |
|
||||||
|
| v1 (legacy) | Standalone bash scripts, manual install | Archived — see [Legacy section](#legacy-v1-shell-scripts) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Version 2 (beta) — Debian package
|
||||||
|
|
||||||
|
Compatibility: PVE 9.0+
|
||||||
|
|
||||||
|
TBD PICTURE
|
||||||
|
|
||||||
|
`pve-mod` is a Debian package that installs UI patches and an interactive configuration wizard.
|
||||||
|
|
||||||
|
### Mods
|
||||||
|
|
||||||
|
| Mod | Description | Dependencies |
|
||||||
|
|--------|-------------|--------------|
|
||||||
|
| [`node_info`](src/modules/node_info/readme.md) | Displays sensor readings in the node summary panel: CPU, NVMe/HDD/SSD temperatures (°C/°F), fan speeds, RAM temperatures, GPU stats (Intel/NVIDIA), UPS status, and system/motherboard info. <br> Can optionally run as background sensor daemon | - General sensors: `lm-sensors`<br>- HDD/SSD: Kernal module `drivetemp`<br>- UPS: `upsc`<br>- GPU: INTEL `intel-gpu-tools` and/or NVIDIA `nvidia-driver-* `
|
||||||
|
| [`nag_screen`](src/modules/nag_screen/readme.md) | Removes the subscription nag screen from the PVE web UI. | - |
|
||||||
|
|
||||||
|
### How it works
|
||||||
|
|
||||||
|
1. The `pve-mod` package installs the mods installation, patch files under `/usr/lib/pve-mod/`.
|
||||||
|
2. The mods main configuration file and mods can be found under `/etc/pve-mod/`.
|
||||||
|
2. Running `pve-mod-configure` prompts for which modules to enable and configuration of mods.
|
||||||
|
3. The wizard applies the selected patches to the PVE system files and restarts `pveproxy`.
|
||||||
|
|
||||||
|
### Install
|
||||||
|
|
||||||
|
Commands and mod configuration must be run as `root`.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -sL https://github.com/Meliox/PVE-mods/releases/latest/download/install.sh | bash
|
||||||
|
```
|
||||||
|
|
||||||
|
Install respective mod dependencies - see Mod table.
|
||||||
|
|
||||||
|
Run `pve-mod-configure` to install/uninstall and configure mods.
|
||||||
|
|
||||||
|
#### Manual configuration changes
|
||||||
|
Configuration files are located in `/etc/pve-mod/`. After any manual edits, restart `pveproxy` to apply the changes:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
systemctl restart pveproxy
|
||||||
|
```
|
||||||
|
|
||||||
|
### Uninstall
|
||||||
|
|
||||||
|
Commands and mod configuration must be run as `root`.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
apt-get remove pve-mod
|
||||||
|
```
|
||||||
|
And remove dependencies needed by respective mods.
|
||||||
|
|
||||||
|
### Notes
|
||||||
|
|
||||||
|
Multiple node support requires application to be installed on all nodes with identical configuration. (untested)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Legacy / v1 (shell scripts)
|
||||||
|
|
||||||
|
> **These scripts are archived.** For new installations, use the [v2 Debian package](#version-2--debian-package) above.
|
||||||
|
|
||||||
|
### Node sensor readings view
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
Compatibility:
|
Compatibility:
|
||||||
- 9.0-9.2. Newer versions may often work
|
- 9.0-9.2. Newer versions may often work
|
||||||
- Older version (7.x-8.x), use git version from Apr 6th 2025
|
- Older version (7.x-8.x), use git version from Apr 6th 2025
|
||||||

|
|
||||||
|
|
||||||
This bash script installs a modification to the Proxmox Virtual Environment (PVE) web user interface (UI) to display sensor readings in a flexible and readable manner.
|
This bash script installs a modification to the Proxmox Virtual Environment (PVE) web user interface (UI) to display sensor readings in a flexible and readable manner.
|
||||||
The following readings are possible:
|
The following readings are possible:
|
||||||
@ -15,7 +84,7 @@ The following readings are possible:
|
|||||||
- UPS information via Network Monitoring Tool
|
- UPS information via Network Monitoring Tool
|
||||||
- Motherboard information or system information via dmidecode
|
- Motherboard information or system information via dmidecode
|
||||||
|
|
||||||
### How it works
|
#### How it works
|
||||||
The modification involves the following steps:
|
The modification involves the following steps:
|
||||||
1. Backup original files in the home directory/backup
|
1. Backup original files in the home directory/backup
|
||||||
- `/usr/share/pve-manager/js/pvemanagerlib.js`
|
- `/usr/share/pve-manager/js/pvemanagerlib.js`
|
||||||
@ -38,7 +107,7 @@ Notes:
|
|||||||
- UPS support in multi-node setups require identical login credentials across nodes. This has not been fully tested.
|
- UPS support in multi-node setups require identical login credentials across nodes. This has not been fully tested.
|
||||||
- Proxmox upgrades may overwrite modified files; reinstallation of this mod could be required.
|
- Proxmox upgrades may overwrite modified files; reinstallation of this mod could be required.
|
||||||
|
|
||||||
### Install
|
#### Install
|
||||||
Instructions be performed as 'root', as normal users do not have access to the files.
|
Instructions be performed as 'root', as normal users do not have access to the files.
|
||||||
|
|
||||||
```
|
```
|
||||||
@ -51,7 +120,7 @@ bash pve-mod-gui-sensors.sh install
|
|||||||
```
|
```
|
||||||
Additionally, adjustments are available in the first part of the script, where paths can be edited, cpucore offset and display information.
|
Additionally, adjustments are available in the first part of the script, where paths can be edited, cpucore offset and display information.
|
||||||
|
|
||||||
## Nag screen deactivation
|
### Nag screen deactivation
|
||||||
(Tested compatibility: 7.x - 8.3.5)
|
(Tested compatibility: 7.x - 8.3.5)
|
||||||
This bash script installs a modification to the Proxmox Virtual Environment (PVE) web user interface (UI) which deactivates the subscription nag screen.
|
This bash script installs a modification to the Proxmox Virtual Environment (PVE) web user interface (UI) which deactivates the subscription nag screen.
|
||||||
|
|
||||||
@ -65,21 +134,21 @@ The script provides three options:
|
|||||||
| `install` | Installs the modification by applying the necessary changes. |
|
| `install` | Installs the modification by applying the necessary changes. |
|
||||||
| `uninstall` | Removes the modification by restoring the original files from backups. |
|
| `uninstall` | Removes the modification by restoring the original files from backups. |
|
||||||
|
|
||||||
### Install
|
#### Install
|
||||||
Instructions be performed as 'root', as normal users do not have access to the files.
|
Instructions be performed as 'root', as normal users do not have access to the files.
|
||||||
```
|
```
|
||||||
wget https://raw.githubusercontent.com/Meliox/PVE-mods/refs/heads/main/legacy-scripts/pve-mod-nag-screen.sh
|
wget https://raw.githubusercontent.com/Meliox/PVE-mods/refs/heads/main/legacy-scripts/pve-mod-nag-screen.sh
|
||||||
bash pve-mod-nag-screen.sh install
|
bash pve-mod-nag-screen.sh install
|
||||||
```
|
```
|
||||||
|
|
||||||
## Script to update all containers
|
### Script to update all containers
|
||||||
(Tested compatibility: 7.x - 8.3.5)
|
(Tested compatibility: 7.x - 8.3.5)
|
||||||
|
|
||||||
This script updates all running Proxmox containers, skipping specified excluded containers, and generates a separate log file for each container.
|
This script updates all running Proxmox containers, skipping specified excluded containers, and generates a separate log file for each container.
|
||||||
The script first updates the Proxmox host system, then iterates through each container, updates the container, and reboots it if necessary.
|
The script first updates the Proxmox host system, then iterates through each container, updates the container, and reboots it if necessary.
|
||||||
Each container's log file is stored in $log_path and the main script log file is named container-upgrade-main.log.
|
Each container's log file is stored in $log_path and the main script log file is named container-upgrade-main.log.
|
||||||
|
|
||||||
### Install
|
#### Install
|
||||||
```
|
```
|
||||||
wget https://raw.githubusercontent.com/Meliox/PVE-mods/refs/heads/main/legacy-scripts/updateallcontainers.sh
|
wget https://raw.githubusercontent.com/Meliox/PVE-mods/refs/heads/main/legacy-scripts/updateallcontainers.sh
|
||||||
```
|
```
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user