proxmox-offline-mirror/docs/offline-media.rst
Thomas Lamprecht ffbf5b8904 docs: add intro to offline mirrors and media chapters
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 13:04:33 +02:00

51 lines
1.6 KiB
ReStructuredText

Offline Media
=============
A Medium is a file system location on which mirrors and subscription info will be saved at.
This can be an external, portable disk (for example, USB pen drive) or a local network filesystem
export.
Setting Up a Medium
-------------------
Either run the ``setup`` wizard again, or use the ``config medium add`` command.
For example, to define a new medium containing the
`proxmox-ve-bullseye-no-subscription` and `debian-bullseye` mirrors, run the
following command:
.. code-block:: console
proxmox-offline-mirror config medium add \
--id pve-bullseye \
--mirrors proxmox-ve-bullseye-no-subscription \
--mirrors debian-bullseye \
--sync true \
--verify true \
--mountpoint /path/where/medium/is/mounted
.. _sync_medium:
Syncing a Medium
----------------
To sync the local mirrors to a medium, the following command can be used:
.. code-block:: console
proxmox-offline-mirror medium sync --id pve-bullseye
This command will sync all mirrors linked with this medium to the medium's mountpoint, as well as
sync all offline keys for further processing by ``proxmox-apt-repo`` on the target system.
Using a Medium
--------------
After syncing a medium, unmount it and make it accessible on the (offline)
target system. You can now either manually point apt at the synced snapshots,
or run ``proxmox-apt-repo setup`` to generate a sources.list.d snippet referecing
selected mirrors and snapshots. Don't forget to remove the snippet again after
the upgrade is done.
To activate or update an offline subscription key, either use ``proxmox-apt-repo offline-key`` or
``proxmox-apt-repo setup``.