Guía de instalación Ollama WebGui: Tu GPT local en minutos.

adminFeb 9, 2025

En este artículo vamos a explicar, de la forma más sencilla posible, cómo configurar un servidor de Inteligencia Artificial (IA) en Ubuntu. Si eres nuevo en Linux o en el mundo de la IA, ¡no te preocupes! Seguiremos cada paso al detalle.

Los pasos que cubriremos son:

Instalación de los Drivers para Tarjetas Gráficas (Nvidia/AMD)
Instalación de OpenWebGUI
Integración de OpenWebGUI con Nginx
Instalación y Configuración de un Certificado SSL
Integración de un Modelo Nuevo: DeepSeek-R1

Requisitos Previos:

Tener instalado Ubuntu (de preferencia Ubuntu 20.04 o superior).

Conexión a Internet.

Acceso a una cuenta con permisos de administrador (sudo).

Conocimientos básicos de terminal, copia/pega de comandos y uso de un editor de texto.

1. Instalación de los Drivers para Tarjetas Gráficas (Nvidia/AMD)

El primer paso es asegurarnos de que el sistema reconoce y utiliza correctamente nuestra tarjeta gráfica. Esto es fundamental para aplicaciones de IA, ya que muchos modelos se ejecutan de forma óptima con el soporte de la GPU.

1.1. Actualización del Sistema

Antes de realizar cualquier instalación, es importante actualizar la lista de paquetes y actualizar el sistema. Esto garantiza que todos los componentes estén en su versión más reciente.

Abre una terminal y escribe:

sudo apt update && sudo apt upgrade -y

¿Qué hace este comando?

sudo apt update: Actualiza la lista de paquetes disponibles desde los repositorios.
sudo apt upgrade -y: Actualiza todos los paquetes instalados a la versión más reciente. El parámetro -y confirma automáticamente todas las preguntas.

1.2. Instalación de Drivers para Tarjetas Nvidia

Si tienes una tarjeta gráfica Nvidia, sigue estos pasos:

Verificar qué driver recomienda Ubuntu: Ejecuta el siguiente comando para ver una lista de drivers recomendados para tu tarjeta:

sudo ubuntu-drivers devices

Este comando escaneará tu sistema y te mostrará información similar a la siguiente:

== /sys/devices/pci0000:00/0000:00:02.0 == 
model : GP106 [GeForce GTX 1060 6GB] 
vendor : NVIDIA Corporation 
modalias : pci:v000010DEd00001C03sv... 
driver : nvidia-driver-470 - distro non-free recommended

Aquí, Ubuntu te está recomendando instalar nvidia-driver-470 (el número puede variar según tu hardware).

Instalar el driver recomendado: Puedes instalar el driver automáticamente ejecutando:

sudo ubuntu-drivers autoinstall

Este comando instalará el driver más adecuado para tu tarjeta gráfica sin que tengas que seleccionar manualmente.

Reiniciar el sistema: Una vez instalado el driver, es importante reiniciar para que los cambios surtan efecto:

sudo reboot

1.3. Instalación de Drivers para Tarjetas AMD

Para usuarios con tarjetas AMD, Ubuntu normalmente utiliza los drivers de código abierto llamados AMDGPU. En muchos casos, esto es suficiente para tareas de IA. Sin embargo, si necesitas la versión propietaria (AMDGPU-PRO), sigue estos pasos:

Descargar el paquete del driver: Visita la página oficial de AMD y busca el paquete de instalación para tu modelo y versión de Ubuntu. Descarga el archivo (generalmente con extensión .tar.xz).
Extraer el paquete descargado: Navega hasta el directorio donde se descargó el archivo y usa el siguiente comando (reemplaza amdgpu-pro-XX.XX-XXXXXX.tar.xz por el nombre real del archivo):

tar -Jxvf amdgpu-pro-XX.XX-XXXXXX.tar.xz

Este comando descomprime el paquete en una carpeta.

Instalar el driver: Entra al directorio extraído y ejecuta el instalador:

cd amdgpu-pro-XX.XX-XXXXXX sudo 
./amdgpu-pro-install -y

Reniciar el sistema:

sudo reboot

Consejo: Si no estás seguro de qué driver necesitas o si tu tarjeta AMD funciona bien con los controladores por defecto, es recomendable usar los drivers de código abierto que ya trae Ubuntu.

2. Instalación de OpenWebGUI

OpenWebGUI es una herramienta que te permite administrar y monitorear tu servidor de IA a través de una interfaz web intuitiva. Vamos a instalarlo desde su repositorio en GitHub.

2.1. Instalación de Git

Primero, asegúrate de tener Git instalado en tu sistema. Git es una herramienta que permite clonar repositorios de código.

Ejecuta en la terminal:

sudo apt install git -y

2.2. Clonar el Repositorio de OpenWebGUI

Navega al directorio /opt (donde se suelen alojar aplicaciones de terceros) y clona el repositorio:

cd /opt
sudo git clone https://github.com/openwebgui/openwebgui.git

Este comando descarga el código fuente de OpenWebGUI en la carpeta: /opt/openwebgui.

2.3. Ejecutar el Script de Instalación

Ingresa al directorio del proyecto:

cd openwebgui

Asegúrate de que el script de instalación tenga permisos de ejecución:

sudo chmod +x install.sh

Ejecuta el script de instalación:

sudo ./install.sh

Durante la ejecución del script, se te pedirán algunos datos de configuración básicos. Lee cada mensaje y, si no estás seguro, presiona Enter para aceptar los valores predeterminados. Recuerda que siempre puedes editar la configuración más tarde en el archivo de configuración de OpenWebGUI.

Importante: Si tienes problemas durante la instalación, consulta la documentación oficial de OpenWebGUI o busca soporte en la comunidad.

3. Integración de OpenWebGUI con Nginx

Para que puedas acceder a OpenWebGUI de forma más segura y profesional, configuraremos Nginx como un proxy inverso. Esto significa que Nginx recibirá las solicitudes de los usuarios y las redirigirá al servicio de OpenWebGUI que, por defecto, se ejecuta en otro puerto (por ejemplo, el 8080).

3.1. Instalación de Nginx

Si aún no tienes Nginx instalado, instálalo con el siguiente comando:

sudo apt install nginx -y

Una vez instalado, Nginx se iniciará automáticamente.

3.2. Configuración de Nginx para OpenWebGUI

Crear el Archivo de Configuración: Crea un archivo de configuración específico para OpenWebGUI:

sudo nano /etc/nginx/sites-available/openwebgui

Agregar la Configuración: Copia y pega el siguiente contenido en el archivo. Asegúrate de cambiar tu-dominio.com por tu dominio real o, si lo haces en una red local, por la IP o nombre que usarás para acceder.

server {
    listen 80;
    server_name tu-dominio.com;

    # Redirige todas las peticiones a OpenWebGUI que corre en el puerto 8080
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Guardar y Salir:En Nano, guarda con Ctrl+O, presiona Enter y luego sal con Ctrl+X.
Activar la Configuración:Crea un enlace simbólico en el directorio sites-enabled para activar la configuración:

sudo ln -s /etc/nginx/sites-available/openwebgui /etc/nginx/sites-enabled/

Verificar la Configuración y Reiniciar Nginx:Antes de reiniciar, es importante verificar que la configuración no tenga errores:

sudo nginx -t

Si la prueba es exitosa, reinicia Nginx para aplicar los cambios:

sudo systemctl restart nginx

Tip para Dummies: Si al escribir el comando sudo nginx -t ves algún error, revisa la sintaxis en el archivo de configuración y asegúrate de que no falte ningún signo de puntuación (como { o ;).

4. Instalación y Configuración del Certificado SSL

Utilizar un certificado SSL garantiza que la conexión a tu servidor sea segura (HTTPS). Vamos a utilizar Let’s Encrypt y su herramienta Certbot para obtener un certificado gratuito.

4.1. Instalación de Certbot

Instala Certbot y el plugin para Nginx:

sudo apt install certbot python3-certbot-nginx -y

4.2. Obtención del Certificado SSL

Ejecuta el siguiente comando para que Certbot configure automáticamente tu dominio:

sudo certbot --nginx -d tu-dominio.com

Durante el proceso, Certbot te preguntará:

Si deseas redirigir todo el tráfico HTTP a HTTPS.
Tu correo electrónico para notificaciones importantes (como la expiración del certificado).
Aceptar los términos del servicio.

Sigue las instrucciones en pantalla y, una vez completado, Certbot modificará la configuración de Nginx para habilitar HTTPS.

4.3. Probar la Renovación Automática

Los certificados de Let’s Encrypt tienen una validez de 90 días, pero Certbot instala automáticamente una tarea para renovarlos. Puedes hacer una prueba de renovación con:

sudo certbot renew --dry-run

Si todo funciona correctamente, verás un mensaje de éxito.

Nota para Novatos: Si tu dominio no está apuntando correctamente al servidor o si trabajas en una red local, la obtención del certificado puede fallar. En ese caso, para pruebas locales, puedes utilizar certificados autofirmados (aunque estos darán advertencias en el navegador) o configurar un dominio válido.

5. Integración de un Modelo Nuevo: DeepSeek-R1

Una vez que nuestro entorno está listo, agregaremos un modelo de IA, en este caso DeepSeek-R1. Este modelo es solo un ejemplo; la idea es mostrarte cómo integrar un modelo nuevo a OpenWebGUI.

5.1. Descarga del Modelo DeepSeek-R1

Para obtener el modelo, clona el repositorio de GitHub en el directorio /opt:

cd /opt
sudo git clone https://github.com/deepseek-ai/DeepSeek-R1.git

Este comando descarga el código y archivos del modelo en /opt/DeepSeek-R1.

5.2. Mover el Modelo a la Carpeta de OpenWebGUI

Es conveniente tener todos los modelos en un directorio específico para OpenWebGUI. Crearemos (si no existe) un directorio para modelos y moveremos el modelo DeepSeek-R1 allí.

Crear el Directorio para Modelos:

sudo mkdir -p /var/openwebgui/models

Copiar el Modelo:

sudo cp -r /opt/DeepSeek-R1 /var/openwebgui/models/

5.3. Configurar OpenWebGUI para Reconocer el Modelo

Para que OpenWebGUI muestre y utilice el modelo DeepSeek-R1, debemos indicarle dónde encontrarlo.

Editar el Archivo de Configuración de OpenWebGUI:El archivo de configuración puede estar ubicado en: /etc/openwebgui/config.yml (la ubicación puede variar según la instalación). Abre el archivo con:

sudo nano /etc/openwebgui/config.yml

Agregar una Entrada para el Modelo:Dentro del archivo, busca la sección donde se listan los modelos (si no existe, créala) y agrega algo similar a:

models:
  - name: DeepSeek-R1
    path: /var/openwebgui/models/DeepSeek-R1
    description: "Modelo DeepSeek-R1 para procesamiento avanzado de IA."

Guarda y cierra el archivo (Ctrl+O, Enter, Ctrl+X).

Reiniciar OpenWebGUI:Para que los cambios en la configuración tengan efecto, reinicia el servicio de OpenWebGui:

sudo systemctl restart openwebgui

Recomendación: Algunos modelos pueden requerir dependencias adicionales (librerías específicas, versiones de Python, etc.). Consulta la documentación del proyecto DeepSeek-R1 para asegurarte de que se cumplan todos los requisitos.

6. Acceso al Panel de OpenWebGUI

Abrir el Navegador Web: Abre tu navegador preferido (por ejemplo, Chrome, Firefox o Edge).
Ingresar la URL del Panel:En la barra de direcciones, escribe la URL correspondiente a tu servidor.

Si configuraste tu dominio, ingresa: https://tu-dominio.com

Al cargar la página, verifica que se muestre el candado en la barra de direcciones, lo que indicará que el certificado SSL se ha instalado correctamente y la conexión es segura:

Nota: Si estás trabajando en una red local y no has configurado un dominio, utiliza la dirección IP del servidor (por ejemplo, https://192.168.1.100).

Pantalla de Inicio de Sesión: La primera vez que accedas, verás la pantalla de inicio de sesión de OpenWebGUI.

Si el instalador ya configuró un usuario administrador, utiliza las credenciales proporcionadas durante la instalación. En caso de que se hayan generado credenciales por defecto (por ejemplo, usuario admin y contraseña admin o una asignada en el proceso de instalación), ingrésalas.

Importante: Por motivos de seguridad, si usas credenciales por defecto, cambia la contraseña lo antes posible.

7. Primeros Pasos en el Panel de Administración

Una vez que ingreses al panel, te encontrarás con una interfaz diseñada para facilitar la administración y monitorización de tu servidor de IA. A continuación, se describen las principales secciones y acciones recomendadas para comenzar:

7.1. Explorar el Dashboard (Panel Principal)

Estado General del Sistema: En el dashboard se mostrará un resumen del rendimiento del servidor, que incluye:
- Uso de CPU y memoria.
- Estado y utilización de la GPU.
- Notificaciones o alertas de funcionamiento (por ejemplo, si algún servicio tiene problemas).
Widgets y Estadísticas: Es posible que encuentres gráficos y widgets interactivos que te permitan ver tendencias, como el tráfico de datos o el rendimiento del modelo de IA. Esto te ayudará a identificar rápidamente si todo funciona correctamente.

7.2. Configuración del Perfil de Usuario

Cambiar la Contraseña:
Accede a la sección de perfil o «Usuarios» para modificar la contraseña del usuario administrador. Esta acción es esencial para mantener la seguridad del sistema.
Datos del Usuario:
Actualiza cualquier otra información de contacto o preferencia que el panel ofrezca, como el idioma o notificaciones por correo.

7.3. Revisar la Sección de Modelos

Listado de Modelos: En esta sección deberías ver todos los modelos integrados. Para nuestro ejemplo, deberías ver DeepSeek-R1 listado entre ellos.
Ver Detalles del Modelo: Haz clic en DeepSeek-R1 para acceder a información detallada, como:
- La ruta de instalación.
- El estado actual (activo, en pausa, etc.).
- Registros y estadísticas propias del modelo.

7.4. Configuración del Sistema y Ajustes Generales

Ajustes del Servidor: En la sección de configuración encontrarás parámetros que te permitirán optimizar el rendimiento del servidor de IA, como la asignación de recursos, la configuración de la red, y otros ajustes avanzados.
Configuración de Notificaciones: Establece alertas para que el sistema te notifique en caso de errores, sobrecargas o cualquier otro incidente relevante. Esto puede incluir notificaciones por correo electrónico o mensajes en el panel.
Revisión de Logs: Es recomendable familiarizarte con la sección de “Logs” o “Registros”. Aquí podrás revisar eventos históricos y detectar problemas en caso de que algo no funcione como se espera.

7.5. Consultar la Documentación y Ayuda Integrada

Sección de Ayuda/Documentación: Muchos paneles de administración incluyen una sección de ayuda, tutoriales o documentación interna. Dedica unos minutos a explorarla para conocer todas las funcionalidades y opciones disponibles.
Soporte y Comunidad: Si en algún momento encuentras dificultades o tienes dudas, revisa los foros de la comunidad o la documentación oficial en la web de OpenWebGUI. Allí podrás encontrar guías, consejos y soluciones a problemas comunes.

8. Siguientes Pasos Recomendados

Personalización Inicial:
- Ajusta el diseño del panel según tus preferencias. Muchos sistemas permiten mover o redimensionar widgets en el dashboard.
- Configura el idioma y la zona horaria según tu región.
Pruebas Funcionales:
- Realiza pruebas de carga en el modelo DeepSeek-R1 con datos de prueba para asegurarte de que el procesamiento se realice correctamente.
- Observa los registros de actividad para detectar cualquier error o advertencia.
Monitoreo Continuo:
- De forma regular, revisa el dashboard y los logs para mantenerte al tanto del estado del servidor y del modelo.
- Configura notificaciones para recibir alertas de posibles incidencias.

Con estos pasos iniciales, ya tendrás un buen punto de partida para utilizar y administrar tu servidor de IA local con OpenWebGUI. Explora cada sección, familiarízate con las opciones y, poco a poco, irás descubriendo todas las funcionalidades que te ofrece la plataforma. ¡Disfruta de la experiencia y empieza a experimentar con tus modelos de inteligencia artificial!