no-subscription(1)

Synopsis

no-subscription [OPTIONS]… [pve|pbs|pmg|ceph]…

Options

-t FILE: Target specific repository list FILE. Must be one of the default locations. Can be specified only once. Cannot be combined with arguments.
-a: Autorun mode - NOT permitted to run unless allowed by configuration. Verbose user notices suppressed.

Arguments

pve|pbs|pmg|ceph: Perform setup of specific no-subscription repository, disable default one (if present). More can be specified at the same time.

With no argument provided, presence of existing default repository list(s) will be taken as an indication which list(s) to set up, except when used with -t option.

Configuration

The following files are sourced for option variables:

/etc/free-pmx/no-subscription.conf: Shared configuration file. File can be pre-created before package install to avoid default behaviour during first install.
/etc/os-release: Comes with standard Proxmox/Debian install and contains operating system identification data. It is used to determine Debian release codename to set up the correct repositories.

no-subscription.conf

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

FREE_PMX_NO_SUBSCRIPTION=VALUE

Determines when and how the repository lists are set up.

auto: Lists are set up upon install and whenever brought in via Proxmox package install.
manual: Lists can ONLY be set up by invoking the command.
prohibit: Lists will NOT be set up and the command invocation will reject setup.

FREE_PMX_CEPH=VALUE

Actual Ceph release name, e.g. quincy, reef, squid.

Operation

In detection mode, default list file names - not contents - are used to determine which list(s) to set up. New lists (with no-subscription as part of their file name) are created UNLESS the files already exist.

Original lists are disabled by appending .disabled suffix to their names so as not to clutter the GUI list any more while having been retained intact.

Note	This is NOT the same as 'disabling' such lists using the Proxmox GUI - which instead performs changes in the files contents.

Default lists

The recognised default list files under /etc/apt/sources.list.d directory:

pve-enterprise.list
pbs-enterprise.list
pmg-enterprise.list
ceph.list

No-subscription lists

The new list files that can be created under /etc/apt/sources.list.d directory:

pve-no-subscription.list
pbs-no-subscription.list
pmg-no-subscription.list
ceph-no-subscription.list

Proxmox release key

Proxmox release key is checked for presence in:

/etc/apt/trusted.gpg.d/proxmox-release-<debian_release_codename>.gpg

If not present, it is retrieved from: https://enterprise.proxmox.com/debian/

Exit status

0

Success. Includes scenarios, such as:

setup is prohibited by configuration; or
some default lists are missing; or
no default lists were found to determine which ones to set up; or
no-subscription lists are already setup.

1

Failure. Issues encountered, such as:

invalid options or arguments provided; or
no system release name could be determined; or
only some of the candidate lists could be set up.

Notes

The command can be used on plain Debian installs without Proxmox packages installed - with explicit argument indicating which Proxmox product repository list to set up - before proceeding with the actual Proxmox product installation. It will retrieve the correct Proxmox release key and set up the repository list as requested.

no-subscription(1) Manual Page

Name