]> git.proxmox.com Git - proxmox-offline-mirror.git/blob - docs/offline-media.rst
docs: split out chapters into different files
[proxmox-offline-mirror.git] / docs / offline-media.rst
1 Offline Media
2 =============
3
4 Setting Up a Medium
5 -------------------
6
7 Either run the ``setup`` wizard again, or use the ``config medium add`` command.
8 For example, to define a new medium containing the
9 `proxmox-ve-bullseye-no-subscription` and `debian-bullseye` mirrors, run the
10 following command:
11
12 .. code-block:: console
13
14 proxmox-offline-mirror config medium add \
15 --id pve-bullseye \
16 --mirrors proxmox-ve-bullseye-no-subscription \
17 --mirrors debian-bullseye \
18 --sync true \
19 --verify true \
20 --mountpoint /path/where/medium/is/mounted
21
22 Syncing a Medium
23 ----------------
24
25 To sync the local mirrors to a medium, the following command can be used:
26
27 .. code-block:: console
28
29 proxmox-offline-mirror medium sync --id pve-bullseye
30
31 This command will sync all mirrors linked with this medium to the medium's mountpoint, as well as
32 sync all offline keys for further processing by ``proxmox-apt-repo`` on the target system.
33
34 Using a Medium
35 --------------
36
37 After syncing a medium, unmount it and make it accessible on the (offline)
38 target system. You can now either manually point apt at the synced snapshots,
39 or run ``proxmox-apt-repo setup`` to generate a sources.list.d snippet referecing
40 selected mirrors and snapshots. Don't forget to remove the snippet again after
41 the upgrade is done.
42
43 To activate or update an offline subscription key, either use ``proxmox-apt-repo offline-key`` or
44 ``proxmox-apt-repo setup``.