uVersion
Español
Descargar →

Wiki

Instalar uVersion Server

Elige tu vía: Ubuntu / Debian (paquete .deb), Windows (PowerShell) o Docker.

El servidor uVersion se instala con un solo comando en Ubuntu/Debian, en Windows o mediante Docker. El instalador hace unas preguntas, pone en marcha PostgreSQL, la base de datos, el servicio del sistema y el certificado HTTPS, y luego te muestra tu contraseña de administrador. Calcula diez minutos.

Vocabulario

Seis palabras aparecen por todas estas páginas. Si alguna te resulta ajena, esta sección basta: no se da por conocido nada más.

  • Carpeta de datos: la carpeta donde el servidor escribe todo lo que te pertenece, es decir, el contenido de tus archivos versionados, su certificado y su identidad. La eliges durante la instalación. Es la carpeta que debes respaldar.
  • Clúster PostgreSQL: una instancia de base de datos, con su propia carpeta y su propio puerto. Una misma máquina puede alojar varios sin que se vean entre sí. uVersion usa el del sistema, o el suyo, según lo que respondas.
  • Servicio del sistema: un programa que se ejecuta en segundo plano y se reinicia solo al arrancar la máquina. Se llama «servicio de Windows» en Windows y «unidad systemd» en Linux.
  • Huella TLS: una cadena de 64 caracteres que identifica el certificado del servidor. La confirmas una vez en cada puesto, como la primera conexión SSH a una máquina.
  • Código de activación: el código UV-XXXX-XXXX-XXXX recibido por correo. El instalador lo canjea por tu licencia completa. Solo sirve una única vez.
  • Purga: la desinstalación completa de un paquete, incluidas sus respuestas de configuración. En Debian, apt remove retira el programa, apt purge retira además sus ajustes.

Requisitos previos

  • Una máquina (VPS, mini-PC, servidor de oficina) con Ubuntu 24.04+, Debian 13+, o Windows 10, 11, Server 2019+. El contenedor Docker cubre las demás distribuciones.
  • Derechos de administración sobre esa máquina: root en Linux, en la práctica mediante sudo, o un PowerShell «Ejecutar como administrador» en Windows. El instalador se niega a arrancar sin ellos.
  • Tu código de activación de uVersion (formato UV-XXXX-XXXX-XXXX) recibido por correo al emitirse tu licencia, o recuperable desde tu área de cuenta. Este código es de un solo uso: una vez canjeado, ya no puede servir en otra máquina.
  • Un acceso a Internet saliente hacia licence.uversion.io (HTTPS), durante el canje del código. En una red sin acceso a Internet, consulta la sección «Instalación no interactiva y sin conexión» de la página de Ubuntu: el instalador también acepta la clave de licencia completa, que recuperas desde tu área de cuenta en otro puesto.
  • PostgreSQL. En Ubuntu y Debian llega automáticamente como dependencia del paquete, no tienes que hacer nada. En Windows, el instalador lo instala mediante winget, ausente de Windows Server 2019 y 2022: en esas dos versiones, instala PostgreSQL 16 a mano antes de lanzar el script.
  • Espacio en disco. El servidor en sí y la base de datos pesan poco: es el almacén de fragmentos (el contenido de tus archivos, todas las revisiones juntas) el que domina, así que dimensiona según el tamaño de tus proyectos Unreal y su historial. Si colocas también la base de datos en la carpeta de datos, el instalador escribe allí además un archivo de lastre de 1 GB, que debes eliminar en caso de disco lleno.
  • El puerto TCP 8443 abierto de entrada, es por ahí por donde se conectan tus puestos. El instalador de Windows crea la regla de cortafuegos por sí mismo. El paquete Debian no abre ningún puerto: hazlo tú mismo, por ejemplo sudo ufw allow 8443/tcp.

Elige tu vía

Ubuntu / Debian

Ubuntu 24.04+, Debian 13+. Instalación mediante paquete .deb.

sudo apt install ./uversion-server_*.deb

Windows

Windows 10, 11, Server 2019+. Una sola línea de PowerShell como Administrador.

iwr https://uversion.io/downloads/server/install.ps1 -UseBasicParsing | iex

Docker

Servidor y base de datos en contenedores. La única vía admitida en la familia Red Hat (RHEL, Rocky, AlmaLinux, Fedora).

docker compose up -d

HTTPS y certificado

El servidor habla únicamente HTTPS, en el puerto 8443. No hay nada que configurar y no hace falta ningún nombre de dominio: en el primer arranque, el servidor genera él mismo su certificado, llamado autofirmado, y muestra su huella SHA-256 al final de la instalación. Cada puesto confirma esta huella una sola vez, en la primera conexión, y después rechaza cualquier huella distinta.

Consecuencia visible: un navegador que abre https://<ip-del-servidor>:8443 muestra una advertencia de seguridad, porque este certificado no está firmado por ninguna autoridad pública. Es lo esperado. Comprueba que la huella mostrada es efectivamente la anotada en la instalación y, a continuación, continúa.

La advertencia de seguridad que muestra el navegador en la primera conexion al servidor, con el boton que permite continuar.

Detalle del procedimiento del lado de los puestos: Huella TLS. Si tu servidor tiene un nombre de dominio y ya dispones de un certificado, puedes colocar el tuyo en su lugar: consulta la sección 2 del runbook de operaciones (docs/operations.md) entregado con el servidor.

¿Y después?

La instalación te muestra, en un recuadro, el usuario admin, una contraseña temporal y la dirección del servidor. Anótalos. Luego te conectas desde cualquier puesto de la red, con un navegador o el cliente de escritorio, en la dirección https://<ip-del-servidor>:8443, donde <ip-del-servidor> es la dirección de la máquina que acabas de instalar.