pve-fake-subscription/README.md

# pve-fake-subscription

![JavaScript free](https://img.shields.io/badge/JavaScript-free-%09%23f7df1e "No JavaScript is involved in this project. ")

Disables the "No valid subscription" dialog on all Proxmox products.

> I am really poor and I can't afford a license. I just want to get rid of the annoying dialog.

## Features

Works for:

- Proxmox VE (5.x or later, tested up to 7.2)
- Proxmox Mail Gateway (5.x or later)
- Proxmox Backup Server (1.x)

Highlights:

- Non-intrusive: zero modification of any system file
- Future-proof: persists between system updates & major upgrades
- Hassle-free: you can uninstall at any time
- Comes with standard Debian package, easy to manage and automate
- **No JavaScript is involved** in the whole process, as I believe JavaScript is harmful to developers

## Installation / Usage

1. [Download the latest release](https://github.com/Jamesits/pve-fake-subscription/releases/latest)
1. Install: run `dpkg -i pve-fake-subscription_*.deb` as root on every node
1. (Optional) `echo "127.0.0.1 shop.maurer-it.com" | sudo tee -a /etc/hosts` to prevent fake keys from being checked against the Proxmox servers

Notes:

After installation, please refrain yourself from clicking the "check" button on the "Subscription" page. It will invalidate the cache and temporary revert your instance into an unlicensed status.

The fake subscription status doesn't grant you free access to the enterprise repository. You should switch to the no-subscription repository if not already done. Use the following method:

- [Proxmox VE (PVE)](https://pve.proxmox.com/wiki/Package_Repositories#sysadmin_no_subscription_repo)
- [Proxmox Mail Gateway (PMG)](https://pmg.proxmox.com/pmg-docs/pmg-admin-guide.html#pmg_package_repositories)
- [Proxmox Backup Server (PBS)](https://pbs.proxmox.com/docs/installation.html#proxmox-backup-no-subscription-repository)

## Uninstallation

Run as root:

```shell
apt purge pve-fake-subscription
```

This will revert your system to a "no subscription key" status.

## Building the Package

Install [nFPM](https://nfpm.goreleaser.com/install/), then:

```shell
./package.sh
```
ditch fpm and use nfpm from now on (as per #3 and #9) 2022-12-19 09:21:24 +00:00			`# pve-fake-subscription`

Update README.md 2022-12-19 09:33:04 +00:00			`![JavaScript free](https://img.shields.io/badge/JavaScript-free-%09%23f7df1e "No JavaScript is involved in this project. ")`

update doc 2021-06-25 11:52:59 +00:00			`Disables the "No valid subscription" dialog on all Proxmox products.`

			`> I am really poor and I can't afford a license. I just want to get rid of the annoying dialog.`
initial commit 2019-04-17 11:41:33 +00:00
Update README.md 2019-08-31 15:45:15 +00:00			`## Features`

update doc 2021-06-25 11:52:59 +00:00			`Works for:`
ditch fpm and use nfpm from now on (as per #3 and #9) 2022-12-19 09:21:24 +00:00
fix line ending issue 2022-09-16 01:11:36 +00:00			`- Proxmox VE (5.x or later, tested up to 7.2)`
update doc 2021-06-25 11:52:59 +00:00			`- Proxmox Mail Gateway (5.x or later)`
			`- Proxmox Backup Server (1.x)`

			`Highlights:`
ditch fpm and use nfpm from now on (as per #3 and #9) 2022-12-19 09:21:24 +00:00
update doc 2021-06-25 11:52:59 +00:00			`- Non-intrusive: zero modification of any system file`
			`- Future-proof: persists between system updates & major upgrades`
			`- Hassle-free: you can uninstall at any time`
			`- Comes with standard Debian package, easy to manage and automate`
			`- No JavaScript is involved in the whole process, as I believe JavaScript is harmful to developers`
Update README.md 2019-08-31 15:45:15 +00:00
doc: binary is now automatically invoked during post install, so no need to wait 2022-12-19 09:35:35 +00:00			`## Installation / Usage`
initial commit 2019-04-17 11:41:33 +00:00
update doc 2021-06-25 11:52:59 +00:00			`1. [Download the latest release](https://github.com/Jamesits/pve-fake-subscription/releases/latest)`
			1. Install: run `dpkg -i pve-fake-subscription_*.deb` as root on every node
			1. (Optional) `echo "127.0.0.1 shop.maurer-it.com" \| sudo tee -a /etc/hosts` to prevent fake keys from being checked against the Proxmox servers

update doc 2021-06-25 12:01:09 +00:00			`Notes:`

fix line ending issue 2022-09-16 01:11:36 +00:00			`After installation, please refrain yourself from clicking the "check" button on the "Subscription" page. It will invalidate the cache and temporary revert your instance into an unlicensed status.`
update 2021-06-25 12:43:02 +00:00
update doc 2021-06-25 12:01:09 +00:00			`The fake subscription status doesn't grant you free access to the enterprise repository. You should switch to the no-subscription repository if not already done. Use the following method:`
ditch fpm and use nfpm from now on (as per #3 and #9) 2022-12-19 09:21:24 +00:00
update doc 2021-06-25 12:01:55 +00:00			`- [Proxmox VE (PVE)](https://pve.proxmox.com/wiki/Package_Repositories#sysadmin_no_subscription_repo)`
			`- [Proxmox Mail Gateway (PMG)](https://pmg.proxmox.com/pmg-docs/pmg-admin-guide.html#pmg_package_repositories)`
			`- [Proxmox Backup Server (PBS)](https://pbs.proxmox.com/docs/installation.html#proxmox-backup-no-subscription-repository)`
update README.md 2019-09-01 12:54:56 +00:00
			`## Uninstallation`

remove fake subscription at purge 2019-09-01 13:16:32 +00:00			`Run as root:`
update README.md 2019-09-01 12:54:56 +00:00
			```shell
			`apt purge pve-fake-subscription`
			```

remove fake subscription at purge 2019-09-01 13:16:32 +00:00			`This will revert your system to a "no subscription key" status.`

update README.md 2019-09-01 12:54:56 +00:00			`## Building the Package`

ditch fpm and use nfpm from now on (as per #3 and #9) 2022-12-19 09:21:24 +00:00			`Install [nFPM](https://nfpm.goreleaser.com/install/), then:`
update README.md 2019-09-01 12:54:56 +00:00
			```shell
			`./package.sh`
			```