Synopsis

free-pmx-no-nag

Configuration

Files

/etc/free-pmx/no-subscription.conf

Shared configuration file is sourced via a shell script. File can be pre-created before package install to avoid default behaviour during first install.

Options

All option names are uppercase, values lowercase. There must NO WHITESPACE between option name, = sign and the assigned value.

FREE_PMX_NO_NAG=VALUE

Determines when and how the notice can be removed.

auto

Notice is removed upon install and whenever the offending source file is brought in via Proxmox package upgrades.

manual

Notice can ONLY be removed by invoking the command, i.e. it may reappear upon upgrades.

prohibit

Notice will NOT be removed and the command invocation will reject removal.

Patching

Files

A single affected source file is patched:

/usr/share/javascript/proxmox-widget-tool‐kit/proxmoxlib.js

An attempt to create a backup copy prior to patching is made - depending on invocation either .original (automated) or .bak (manual) extension is added and the file will be OVERWRITTEN if it already exists. It is thus possible to lose the actual unpatched version if invoked repeatedly when the patch had been already applied.

Difference between different versions can be verified with a diff, e.g.:

diff -u /usr/share/javascript/proxmox-widget-toolkit/proxmoxlib.js{.original,}

Reversal

The original (default) version can be restored by reinstall of the Proxmox package:

apt reinstall proxmox-widget-toolkit

NOTE If FREE_PMX_NO_NAG is configured to auto, such reinstalled version will be instantly put aside as .original file.

Exit status

0

Success. Includes scenarios, such as:

  • patching is probibited by configuration; or

  • backup copies could not be created.

1

Failure. Issues encountered during patching, such as:

  • invalid argument provided; or

  • no file to patch present; or

  • could not determine if patch resulted in modification of the original file.

Also returned when applied patch has NOT resulted in any file change.

Resources

Copying

Copyright © 2025 free-pmx.
Free use of this software is granted under the terms of the AGPL v3 License.