proxmox-nag-buster/README.md

74 lines
2.5 KiB
Markdown
Raw Normal View History

2020-01-22 12:45:46 +00:00
## pve-nag-buster
2020-01-12 06:44:06 +00:00
https://github.com/foundObjects/pve-nag-buster
2019-04-15 08:03:25 +00:00
2020-01-12 06:44:06 +00:00
This is a dpkg post install hook script that persistently removes license nags
2021-05-02 01:51:28 +00:00
from Proxmox VE 6.x and up. Install it once and you won't see another license
2020-01-12 06:44:06 +00:00
nag until Proxmox changes their web-ui code significantly.
2019-04-15 08:03:25 +00:00
2020-01-12 06:44:06 +00:00
Please support the Proxmox team by [buying a subscription](https://www.proxmox.com/en/proxmox-ve/pricing) if it's within your
means. High quality open source software like Proxmox needs our support!
2019-04-15 08:03:25 +00:00
2021-05-02 01:51:28 +00:00
### News:
Last updated for: pve-manager/6.4-4/337d6701 (running kernel: 5.4.106-1-pve)
2020-01-12 06:44:06 +00:00
### How does it work?
2019-04-15 08:03:25 +00:00
2020-01-12 06:44:06 +00:00
The included hook script removes the "unlicensed node" popup nag from the web
gui and disables the pve-enterprise repository list. This script is called
every time a package updates the web gui or the pve-enterprise source list and
2020-06-12 12:32:32 +00:00
will only run if packages containing those files are changed.
2021-05-02 01:51:28 +00:00
The installer creates a dpkg hook script, adds the pve-no-subscription repo list
and calls the hook script once. There are no external dependencies beyond the base
packages installed with PVE by default.
2019-04-15 08:03:25 +00:00
2020-01-12 06:44:06 +00:00
### Installation
2020-01-22 12:45:46 +00:00
```sh
2019-04-15 08:03:25 +00:00
wget https://raw.githubusercontent.com/foundObjects/pve-nag-buster/master/install.sh
2020-01-22 12:45:46 +00:00
2020-01-12 06:44:06 +00:00
# Always read scripts downloaded from the internet before running them with sudo
2020-01-22 12:45:46 +00:00
sudo bash install.sh
# or ..
2020-01-12 06:44:06 +00:00
chmod +x install.sh && sudo ./install.sh
2019-04-15 08:03:25 +00:00
```
2020-01-12 06:44:06 +00:00
With Git:
2020-01-22 12:45:46 +00:00
```sh
2020-01-12 06:44:06 +00:00
git clone https://github.com/foundObjects/pve-nag-buster.git
2020-01-22 12:45:46 +00:00
2020-01-12 06:44:06 +00:00
# Always read scripts downloaded from the internet before running them with sudo
cd pve-nag-buster && sudo ./install.sh
```
### Uninstall:
2020-01-22 12:45:46 +00:00
```sh
sudo ./install.sh --uninstall
2020-01-12 06:44:06 +00:00
# remove /etc/apt/sources.list.d/pve-no-subscription.list if desired
```
### Notes:
2020-01-22 12:45:46 +00:00
#### Why is there base64 in my peanut-butter?
For convenience the install script also contains a base64 encoded copy of the
hook script, this makes installation possible without access to github or a
full clone of the project directory.
To inspect the base64 encoded script run `./install.sh --emit`; this dumps the
encoded copy to stdout and quits. To install using the stored copy just run
`sudo ./install.sh --offline`, no internet required.
2021-05-02 01:51:28 +00:00
### Thanks to:
2020-01-12 06:44:06 +00:00
2021-05-02 01:51:28 +00:00
- John McLaren for his [blog post](https://www.reddit.com/user/seaqueue) documenting the web gui patch.
- [Marlin Sööse](https://github.com/msoose) for the update for PVE 6.3+
2020-01-12 06:44:06 +00:00
### Contact:
2021-05-02 01:51:28 +00:00
[Open an issue](https://github.com/foundObjects/pve-nag-buster/issues) on GitHub
2020-01-12 06:44:06 +00:00
2019-04-15 08:03:25 +00:00
Please get in touch if you find a way to improve anything, otherwise enjoy!
2020-01-12 06:44:06 +00:00