{"id":3258,"date":"2025-12-28T01:06:45","date_gmt":"2025-12-27T23:06:45","guid":{"rendered":"https:\/\/www.sinetiqueta.com\/?p=3258"},"modified":"2025-12-28T02:14:45","modified_gmt":"2025-12-28T00:14:45","slug":"como-solucionar-el-error-de-api-en-portainer-con-openmediavault-y-docker-compose","status":"publish","type":"post","link":"https:\/\/www.sinetiqueta.com\/?p=3258","title":{"rendered":"C\u00f3mo solucionar el error de API en Portainer con OpenMediaVault y Docker Compose"},"content":{"rendered":"\n

Si gestionas tus contenedores Docker mediante el plugin Compose<\/strong> en OpenMediaVault (OMV)<\/strong>, es posible que tras una actualizaci\u00f3n del sistema te hayas encontrado con que Portainer deja de funcionar. El contenedor no arranca y, al revisar los logs, te encuentras con un error cr\u00edtico de \u00abAPI version\u00bb.<\/p>\n\n\n\n

Cabe mencionar que NO soy un experto en el tema<\/strong>, y me sirvo de las herramientas a mi alcance para conseguir solucionar este tipo de cosas<\/em>.<\/p>\n\n\n\n

En este art\u00edculo explicamos por qu\u00e9 sucede esto y c\u00f3mo solucionarlo paso a paso.<\/p>\n\n\n\n

1. El Problema: El error de \u00abClient Version is too old\u00bb<\/h2>\n\n\n\n

El error suele presentarse con un mensaje similar a este:<\/p>\n\n\n\n

FTL > failed initializing upgrade service | error=\"failed to determine container platform: ... client version 1.42 is too old. Minimum supported API version is 1.44\"<\/code><\/pre>\n\n\n\n
\u00bfPor qu\u00e9 ocurre?<\/h3>\n\n\n\n
Este fallo sucede porque el motor de Docker en tu servidor se ha actualizado (probablemente a la versi\u00f3n 26 o 27), la cual requiere una versi\u00f3n de la API de Docker m\u00ednima (1.44). Si est\u00e1s intentando ejecutar una imagen de Portainer antigua o la versi\u00f3n obsoleta (portainer\/portainer<\/code>), el cliente interno de Portainer no sabe \u00abhablar\u00bb con el nuevo motor de Docker.<\/p>\n\n\n\n
2. La Soluci\u00f3n: Actualizar a Portainer CE<\/h2>\n\n\n\n
La soluci\u00f3n definitiva consiste en migrar a la imagen oficial mantenida:<\/p>\n\n\n\n
portainer\/portainer-ce<\/code><\/pre>\n\n\n\n
Paso 1: Editar el archivo Docker Compose<\/h3>\n\n\n\n
Desde el panel de OMV, ve a Servicios > Compose > Files<\/strong>, selecciona tu stack de Portainer y pulsa Editar<\/strong>. Debes asegurarte de que tu configuraci\u00f3n sea similar a esta:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
\n
services:
  portainer:
    image: portainer\/portainer-ce:latest  # Usar siempre la Community Edition
    container_name: portainer-ce          # Cambiamos el nombre si el anterior da conflicto
    restart: unless-stopped
    security_opt:
      – no-new-privileges:true
    volumes:
      – \/etc\/localtime:\/etc\/localtime:ro
      – \/var\/run\/docker.sock:\/var\/run\/docker.sock:ro
      – .\/data:\/data                      # Persistencia de datos
    ports:
      – 9443:9443                         # Acceso seguro v\u00eda HTTPS<\/mark><\/p>\n<\/blockquote>\n\n\n\n
Paso 2: Resolver conflictos de nombre<\/h3>\n\n\n\n
Si al intentar levantar el contenedor recibes un error de \u00abConflict. The container name is already in use\u00bb<\/strong>, Docker tiene un contenedor \u00abzombi\u00bb bloqueando el nombre. Tienes dos opciones:<\/p>\n\n\n\n
    \n
  1. Limpieza por SSH:<\/strong> Ejecuta $ docker rm -f portainer<\/strong><\/code> para borrar el contenedor antiguo. He usado Putty<\/strong><\/a>, recuerda que el usuario con el que inicies sesi\u00f3n debe tener permisos SUDO<\/strong> y _SSH<\/strong>, esto lo ocnfiguras dentro del OMV en USERS.<\/li>\n\n\n\n
  2. Renombrado r\u00e1pido:<\/strong> Cambia el container_name<\/code> en tu YAML (por ejemplo, de portainer<\/code> a portainer-ce<\/code>), como hicimos en el ejemplo anterior.<\/li>\n<\/ol>\n\n\n\n
    3. Aplicar los cambios en OpenMediaVault<\/h2>\n\n\n\n
    Una vez editado el archivo, muchos usuarios cometen el error de pulsar directamente el bot\u00f3n \u00abUp\u00bb. Sin embargo, si quieres solucionar el error de la API, el orden de los factores s\u00ed altera el producto<\/strong>. Sigue estos pasos:<\/p>\n\n\n\n
      \n
    1. Save:<\/strong> Guarda los cambios en el editor. Esto registra tu nueva configuraci\u00f3n en la base de datos de OMV.<\/li>\n\n\n\n
    2. Pull (CRUCIAL):<\/strong> Haz clic en el bot\u00f3n de descarga (icono de la flecha hacia abajo ⬇️).\n