--- title: "Cómo instalar Proxmox VE 8 sobre Debian 12 Bookworm" description: "Instala Proxmox VE 8 sobre Debian 12 en un servidor dedicado: repositorio, kernel, bridge vmbr0, IPs adicionales para VMs y almacenamiento LVM en el grupo vg0." category: "Servidores Dedicados" language: es source: https://cubepath.com/es/docs/servidores-dedicados/instalar-proxmox-ve-en-debian-12-bookworm updated: 2026-09-25 --- # Cómo instalar Proxmox VE 8 sobre Debian 12 Bookworm Proxmox VE es una plataforma de virtualización de código abierto que combina máquinas virtuales KVM y contenedores LXC con una interfaz web de gestión. Aunque existe una ISO propia, en un servidor dedicado remoto es más cómodo instalarlo sobre un Debian 12 ya instalado. En este tutorial convertirás un servidor dedicado con Debian 12 Bookworm en un nodo Proxmox VE 8, configurarás el bridge de red para las máquinas virtuales, prepararás el uso de IPs adicionales y añadirás el almacenamiento LVM para los discos de las VMs. > Importante: Proxmox VE 8 se basa en Debian 12 y está al final de su ciclo de soporte. Para un nodo nuevo que vaya a estar muchos años en producción, valora instalar Proxmox VE 9 sobre Debian 13 siguiendo la documentación oficial de Proxmox. Esta guía sigue siendo válida para nodos que deban quedarse en Debian 12. ## Requisitos previos - Un servidor dedicado de CubePath con Debian 12 Bookworm instalado desde el panel de control (consulta la guía "Instalar el sistema operativo en un servidor dedicado"). Al instalarlo, deja espacio libre en el grupo de volúmenes LVM `vg0`, que usaremos para los discos de las máquinas virtuales. - Una CPU con virtualización por hardware (Intel VT-x o AMD-V), algo que tienen todos los servidores dedicados actuales. - Acceso SSH como `root`. Todos los comandos de esta guía se ejecutan como `root`; si entras con otro usuario, cambia con `su -`. - La IP principal del servidor, su máscara y su gateway, visibles en tu área de cliente. > Advertencia: en el paso 6 modificarás la configuración de red. Un error puede dejarte sin acceso SSH, así que revisa los datos dos veces antes de aplicar los cambios. ## Paso 1: Comprobar el nombre de host Proxmox necesita que el nombre del servidor resuelva a su IP pública, no a `127.0.1.1`. Comprueba qué IP devuelve: ```bash hostname --ip-address ``` Si la salida no es la IP pública del servidor, edita `/etc/hosts`: ```bash nano /etc/hosts ``` Deja una línea con la IP pública, el nombre completo y el nombre corto, y elimina o comenta cualquier línea `127.0.1.1` con el mismo nombre. Sustituye `your_server_ip` y `pve1.your_domain` por tus valores: ```text 127.0.0.1 localhost your_server_ip pve1.your_domain pve1 ``` Vuelve a comprobarlo; ahora debe mostrar solo la IP pública: ```bash hostname --ip-address ``` ```output 203.0.113.10 ``` ## Paso 2: Añadir el repositorio de Proxmox VE Descarga la clave con la que Proxmox firma sus paquetes para Bookworm en el directorio de claves de apt: ```bash install -d -m 0755 /etc/apt/keyrings wget -qO /etc/apt/keyrings/proxmox-release-bookworm.gpg https://enterprise.proxmox.com/debian/proxmox-release-bookworm.gpg ``` Puedes verificar su huella con `sha512sum /etc/apt/keyrings/proxmox-release-bookworm.gpg` y compararla con la publicada en la página "Install Proxmox VE on Debian 12 Bookworm" del wiki de Proxmox. Añade el repositorio `pve-no-subscription`, que no requiere suscripción de pago: ```bash echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/proxmox-release-bookworm.gpg] http://download.proxmox.com/debian/pve bookworm pve-no-subscription" > /etc/apt/sources.list.d/pve-install-repo.list ``` Actualiza el índice de paquetes y el sistema: ```bash apt update apt full-upgrade -y ``` `apt update` debe mostrar el repositorio de Proxmox sin errores: ```output Get:4 http://download.proxmox.com/debian/pve bookworm InRelease [2,771 B] Get:5 http://download.proxmox.com/debian/pve bookworm/pve-no-subscription amd64 Packages [...] ``` ## Paso 3: Instalar el kernel de Proxmox Proxmox VE usa su propio kernel. Instálalo y reinicia para arrancar con él antes de instalar el resto de paquetes: ```bash apt install -y proxmox-default-kernel systemctl reboot ``` Cuando vuelvas a conectarte, comprueba el kernel en uso. Debe terminar en `-pve`: ```bash uname -r ``` ```output 6.8.12-15-pve ``` ## Paso 4: Instalar los paquetes de Proxmox VE Instala Proxmox VE junto con Postfix (para que el nodo pueda enviar notificaciones), open-iscsi y chrony para la sincronización de hora: ```bash apt install -y proxmox-ve postfix open-iscsi chrony ``` Durante la instalación aparecerá la configuración de Postfix. Si no tienes un servidor de correo propio, elige **Local only**; si vas a enviar correo a través de un relay, elige **Satellite system**. En el nombre de correo del sistema, deja el nombre del servidor. Elimina ahora el kernel de Debian, que ya no se necesita, y regenera la configuración de GRUB: ```bash apt remove -y linux-image-amd64 'linux-image-6.1*' update-grub ``` Elimina también `os-prober`, que en un hipervisor puede detectar sistemas dentro de los discos de las VMs y añadirlos por error al menú de arranque: ```bash apt remove -y os-prober ``` Si existe el archivo `/etc/apt/sources.list.d/pve-enterprise.list`, coméntalo o elimínalo: ese repositorio requiere suscripción y `apt update` devolverá un error `401 Unauthorized` sin ella. ## Paso 5: Acceder a la interfaz web Comprueba que el servicio de la interfaz web está activo: ```bash systemctl status pveproxy --no-pager ``` ```output ● pveproxy.service - PVE API Proxy Server Loaded: loaded (/lib/systemd/system/pveproxy.service; enabled; preset: enabled) Active: active (running) since ... ``` Abre en el navegador: ```text https://your_server_ip:8006 ``` Acepta el aviso del certificado autofirmado e inicia sesión con el usuario `root`, la contraseña de `root` del sistema y el realm **Linux PAM standard authentication**. Aparecerá un aviso de que no tienes suscripción válida; puedes cerrarlo, no impide usar Proxmox. ## Paso 6: Configurar el bridge de red vmbr0 Las máquinas virtuales se conectan a la red a través de un bridge. Vas a crear `vmbr0`, moverle la IP principal del servidor y asociarle la interfaz física. Primero identifica el nombre de la interfaz principal y los datos de red actuales: ```bash ip -br addr ip route show default ``` ```output lo UNKNOWN 127.0.0.1/8 ::1/128 eno1 UP 203.0.113.10/24 fe80::... default via 203.0.113.1 dev eno1 onlink ``` En este ejemplo la interfaz es `eno1`, la IP `203.0.113.10/24` y el gateway `203.0.113.1`. Haz una copia de la configuración actual: ```bash cp /etc/network/interfaces /etc/network/interfaces.bak ``` Edita el archivo: ```bash nano /etc/network/interfaces ``` Sustituye su contenido por lo siguiente, cambiando `eno1`, la IP y el gateway por los de tu servidor: ```text auto lo iface lo inet loopback iface eno1 inet manual auto vmbr0 iface vmbr0 inet static address 203.0.113.10/24 gateway 203.0.113.1 bridge-ports eno1 bridge-stp off bridge-fd 0 ``` Si el archivo original contenía una sección IPv6 o líneas `dns-nameservers`, trasládalas al bloque de `vmbr0`. Aplica la nueva configuración (Proxmox instala `ifupdown2`, que permite recargar la red sin reiniciar): ```bash ifreload -a ``` Comprueba que la IP está ahora en el bridge y que hay salida a internet: ```bash ip -br addr show vmbr0 ping -c 3 1.1.1.1 ``` ```output vmbr0 UP 203.0.113.10/24 fe80::... ``` Si pierdes la conexión, entra por una consola remota (KVM o IPMI) si la tienes disponible, o contacta con soporte; desde la consola, restaura la copia con `cp /etc/network/interfaces.bak /etc/network/interfaces` y ejecuta `ifreload -a`. ## Paso 7: Preparar el uso de IPs adicionales en las VMs Si tienes IPs adicionales y quieres asignarlas a máquinas virtuales, activa el reenvío de paquetes IPv4 en el nodo con un archivo propio en `/etc/sysctl.d/`: ```bash echo "net.ipv4.ip_forward=1" > /etc/sysctl.d/99-ip-forward.conf sysctl --system ``` Verifica que está activo: ```bash sysctl net.ipv4.ip_forward ``` ```output net.ipv4.ip_forward = 1 ``` Al configurar la red dentro de cada VM (conectada a `vmbr0`), usa estos valores: | Parámetro | Valor | | --- | --- | | Dirección IP | La IP adicional con máscara `/24`, por ejemplo `198.51.100.25/24` | | Gateway | La IP principal del nodo, por ejemplo `203.0.113.10` | ## Paso 8: Añadir el almacenamiento LVM para las VMs Los discos de las máquinas virtuales se crearán como volúmenes lógicos dentro del grupo de volúmenes `vg0`. Comprueba que existe y cuánto espacio libre tiene: ```bash vgs ``` ```output VG #PV #LV #SN Attr VSize VFree vg0 1 3 0 wz--n- 893.00g 800.00g ``` En la interfaz web, ve a **Datacenter > Storage**, pulsa **Add** y elige **LVM**. Rellena el formulario así: - **ID**: `local-lvm` - **Volume group**: `vg0` - **Content**: `Disk image, Container` ![Añadir almacenamiento LVM en Datacenter > Storage](https://panel.cubepath.com/images/kb/9_Screenshot_20240327_191817.png) ![Formulario de almacenamiento LVM con el grupo de volúmenes vg0](https://panel.cubepath.com/images/kb/10_Screenshot_20240327_191612.png) Pulsa **Add** y comprueba desde la terminal que el almacenamiento está activo: ```bash pvesm status ``` ```output Name Type Status Total Used Available % local dir active 30832548 3528572 25714730 11.44% local-lvm lvm active 936378368 94371840 842006528 10.08% ``` A partir de ahora, crea todas las VMs en el almacenamiento `local-lvm`. Proxmox creará un volumen lógico en `vg0` para cada disco de cada máquina virtual. ## Conclusión Tu servidor dedicado funciona ya como nodo Proxmox VE 8, con la red en bridge, reenvío activado para IPs adicionales y almacenamiento LVM listo para las máquinas virtuales. Como siguientes pasos, sube una ISO a **local > ISO Images** y crea tu primera VM, configura la autenticación en dos pasos para `root` en **Datacenter > Permissions > Two Factor**, y planifica copias de seguridad de las VMs en **Datacenter > Backup**.