proxmox-mirrors/proxmox-offline-mirror
1
0
Fork 0
mirror of https://git.proxmox.com/git/proxmox-offline-mirror synced 2025-08-15 20:13:58 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

docs: document key handling

Browse Source 
Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
This commit is contained in:
Fabian Grünbichler 2022-07-22 11:07:20 +02:00
parent e34d988080
commit abaee27150
1 changed files with 30 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
docs/introduction.rst
View File

@ -30,6 +30,33 @@ A default config path of `/etc/proxmox-offline-mirror.cfg` is used, but is
overridable on a per command basis (for example, to allow operation as non-root overridable on a per command basis (for example, to allow operation as non-root
user). user).
Offline subscription keys
=========================
When using `proxmox-offline-mirror` with a corresponding Proxmox Offline Mirror subscription key,
it is possible to update subscription information for air-gapped systems or those without access
to the public internet.
First, add the mirror key using `proxmox-offline-mirror key add-mirror-key`. This command will
activate the subscription of the mirroring system.
Next, gather the server IDs of the systems that shall be set up for offline keys, and add them
together with the system's subscription key using `proxmox-offline-mirror key add`. By default,
this command will fetch updated subscription information from Proxmox licensing servers.
You can refresh the subscription information for a single (`--key XX`) or all configured keys
using `proxmox-offline-mirror key refresh`. The subscription information is transferred to a
medium (see below) and can then be activated on the offline system with either
`proxmox-apt-repo offline-key` or `proxmox-apt-repo setup`. This process must be repeated at least
once a year or before the nextduedate of the subscription key is reached, whichever comes first.
.. note:: Configuring an active product subscription key (*as well as* a Proxmox Offline Mirror
subscription) is required for `proxmox-offline-mirror` to be able to access and mirror a
product's enterprise repository.
Offline repository mirrors
==========================
Setting up a mirror Setting up a mirror
------------------- -------------------
@ -55,6 +82,9 @@ To create the first (and subsequent) snapshots, the following command can be use
proxmox-offline-mirror mirror snapshot create --id debian-bullseye-security proxmox-offline-mirror mirror snapshot create --id debian-bullseye-security
Offline media
=============
Setting up a medium Setting up a medium
------------------- -------------------