PVE 9 (Debian 13 trixie, formato deb822):

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

cat > /etc/apt/sources.list.d/proxmox.sources <<'EOF'
Types: deb
URIs: http://download.proxmox.com/debian/pve
Suites: trixie
Components: pve-no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
EOF

# Apagar enterprise (sin suscripción devuelve 401 en cada apt update)
grep -q '^Enabled:' /etc/apt/sources.list.d/pve-enterprise.sources \
  || echo 'Enabled: false' >> /etc/apt/sources.list.d/pve-enterprise.sources

apt update && apt full-upgrade

PVE 8 (Debian 12 bookworm, formato de una línea):

1
2
3
4
5

echo 'deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription' \
  > /etc/apt/sources.list.d/pve-no-subscription.list
sed -i 's/^deb /# deb /' /etc/apt/sources.list.d/pve-enterprise.list

apt update && apt full-upgrade

Si el host tiene Ceph, el repo enterprise de Ceph también hay que apagarlo y cambiarlo por su no-subscription (abajo).

Qué hace cada repositorio

Proxmox lo dice claro: pve-no-subscription es para pruebas y uso no productivo; en producción quieren que pagues la suscripción y uses enterprise. Para un lab o un homelab es el repo normal.

El 401 de enterprise no rompe nada por sí mismo, pero cada apt update termina con error y el resto de repos queda a medio refrescar. Apagarlo es el arreglo; no hace falta borrarlo.

PVE 9: archivos .sources (deb822)

Desde PVE 9 el instalador ya escribe /etc/apt/sources.list.d/pve-enterprise.sources en formato deb822. Un .sources es un bloque de claves:

1
2
3
4
5
6
7

# /etc/apt/sources.list.d/pve-enterprise.sources
Types: deb
URIs: https://enterprise.proxmox.com/debian/pve
Suites: trixie
Components: pve-enterprise
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
Enabled: false

Enabled: false lo deja escrito pero inactivo. El de no-subscription es el bloque del En corto; el de test es igual con Components: pve-test.

Si arrastras archivos .list de una actualización desde PVE 8, apt 3 los convierte solo:

1

apt modernize-sources

Reescribe cada .list como .sources y deja el original como .list.bak.

PVE 8: archivos .list

1
2
3
4
5

# /etc/apt/sources.list.d/pve-enterprise.list
# deb https://enterprise.proxmox.com/debian/pve bookworm pve-enterprise

# /etc/apt/sources.list.d/pve-no-subscription.list
deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription

Comentar la línea enterprise con # equivale al Enabled: false de deb822.

Ceph

El instalador también deja el repo enterprise de Ceph. Mismo tratamiento; el nombre del repo lleva la versión de Ceph que corre el clúster (ceph -v):

PVE 9:

1
2
3
4
5
6

# /etc/apt/sources.list.d/ceph.sources
Types: deb
URIs: http://download.proxmox.com/debian/ceph-tentacle
Suites: trixie
Components: no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg

Cambia ceph-tentacle por ceph-squid si sigues en Squid. Si el archivo original tenía Components: enterprise, reemplázalo entero por este.

PVE 8:

1
2
3

# /etc/apt/sources.list.d/ceph.list
# deb https://enterprise.proxmox.com/debian/ceph-squid bookworm enterprise
deb http://download.proxmox.com/debian/ceph-squid bookworm no-subscription

En bookworm existen ceph-quincy, ceph-reef y ceph-squid; usa el que corresponda a tu clúster, no el más nuevo.

Proxmox Backup Server

Idéntico patrón con pbs en la URI y pbs-no-subscription como componente:

1
2
3
4
5
6

# /etc/apt/sources.list.d/proxmox.sources (PBS 4, trixie)
Types: deb
URIs: http://download.proxmox.com/debian/pbs
Suites: trixie
Components: pbs-no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg

Y Enabled: false en pbs-enterprise.sources.

Trampas

• No mezcles suites. bookworm en PVE 8, trixie en PVE 9. Una línea con la suite equivocada rompe el siguiente full-upgrade.
• El keyring ya está. /usr/share/keyrings/proxmox-archive-keyring.gpg viene con cualquier instalación desde ISO. Solo hace falta descargarlo cuando instalas Proxmox encima de un Debian limpio (lo explica la guía oficial de esa vía).
• Signed-By es obligatorio en deb822; sin esa línea apt ignora el repo con un aviso.
• Si apt falla con pve-apt-hook: not found, no es un problema de repos: ese es otro post.
• El aviso de “no valid subscription” de la GUI es independiente de los repos y no se arregla aquí; una suscripción Community lo quita y de paso te da el repo enterprise.

Referencia: Package Repositories en la wiki de Proxmox.

1
2
3
4
5

mkdir -p /usr/share/proxmox-ve
touch /usr/share/proxmox-ve/pve-apt-hook
chmod +x /usr/share/proxmox-ve/pve-apt-hook
apt install -f
apt install proxmox-ve

Con proxmox-ve reinstalado, el hook real reemplaza al vacío y apt vuelve a la normalidad.

El error

1
2

/bin/sh: 1: /usr/share/proxmox-ve/pve-apt-hook: not found
E: Failure running script /usr/share/proxmox-ve/pve-apt-hook

Sale en cualquier apt install, apt upgrade o apt full-upgrade, y bloquea todo, incluido lo que intentas hacer para arreglarlo.

Por qué pasa

El paquete proxmox-ve instala dos cosas que van juntas:

Si proxmox-ve se fue (un apt remove o autoremove mal calculado, un dist-upgrade interrumpido, un paquete a medio instalar), el script desaparece pero el archivo de /etc/apt/apt.conf.d/ es un conffile y se queda. apt sigue intentando ejecutar un script que ya no existe y falla antes de tocar nada.

Arreglo si quieres seguir con Proxmox

El hook vacío solo sirve para que apt arranque; lo importante es reinstalar proxmox-ve:

1
2
3
4
5
6

mkdir -p /usr/share/proxmox-ve
touch /usr/share/proxmox-ve/pve-apt-hook
chmod +x /usr/share/proxmox-ve/pve-apt-hook

apt install -f            # cierra dependencias rotas primero (recomendación del staff de Proxmox)
apt install proxmox-ve    # trae de vuelta el hook real y lo que falte

Comprueba que el hook ya es el de verdad y no tu archivo vacío:

1
2

dpkg -S /usr/share/proxmox-ve/pve-apt-hook   # proxmox-ve: /usr/share/proxmox-ve/pve-apt-hook
head -1 /usr/share/proxmox-ve/pve-apt-hook   # #!/usr/bin/perl

Después de esto, apt full-upgrade y un reinicio para confirmar que arranca el kernel de Proxmox.

Arreglo si quitaste Proxmox a propósito

Si la máquina está volviendo a ser un Debian normal, el snippet sobra:

1
2
3

rm /etc/apt/apt.conf.d/10pveapthook
# o, más limpio, purgar lo que quedó del paquete:
dpkg --purge proxmox-ve

apt remove deja los conffiles; purge se los lleva.

Trampas

• No dejes el hook vacío. Existe para que apt no te borre proxmox-ve ni el kernel proxmox-kernel-* por accidente. Con el archivo vacío esa protección no está.
• Revisa qué se fue con proxmox-ve. Si apt lo quitó, probablemente también se llevó dependencias; el apt install proxmox-ve las regresa, pero mira la lista antes de aceptar.
• Si apt install proxmox-ve no encuentra el paquete, el problema está en los repos: repositorios sin suscripción.
• Referencia: hilo del foro de Proxmox.