Aloja un Dominio desde un Servidor Linux Local o en la Nube

Los paquetes Overte pueden ayudarle a poner en funcionamiento su propio dominio rápidamente.

Instalación

If you are setting up Linux just for an Overte server, Debian is recommended as it is popular among Overte developers.

Debian, Ubuntu and derivates

Download the latest package for your distribution from public.overte.org. You can copy the link to the relevant package and download it directly to your remote server using wget. E.g.:

wget https://public.overte.org/build/overte/release/VERSION/overte-server_REST-OF-PACKAGE-NAME_amd64.deb

Pay attention to the amd64 and arm64 in the file name; You want amd64 unless you are installing to a Raspberry Pi or another ARM machine. If you are not sure which version of Debian or Ubuntu you are using, run cat /etc/os-release.

To actually install the package run the following command(s), replacing overte-server_REST-OF-PACKAGE-NAME_amd64.deb with the file name of whatever package you are trying to install:

sudo su  # This may or may not be needed.
apt update && apt install ./overte-server_REST-OF-PACKAGE-NAME_amd64.deb

Keep in mind that apt might print the following notice, which is safe to ignore: Notice: Download is performed unsandboxed as root as file 'overte-server.deb' couldn't be accessed by user '_apt'. - pkgAcquire::Run (13: Permission denied)

You can run these same commands on an existing Overte domain to upgrade it if the original domain was installed using the package.

Fedora

Our Fedora packages aren't as well tested and used as for example Debian/Ubuntu packages; Please report any issues you are running into on our GitHub issue tracker or on Matrix or Discord.

Download the latest package for your distribution from public.overte.org. You can copy the link to the relevant package and download it directly to your remote server using wget. E.g.:

wget https://public.overte.org/build/overte/release/VERSION/overte-server-REST-OF-PACKAGE-NAME.x86_64.rpm

Pay attention to the x86_64 and aarch64 in the file name; You want x86_64 unless you are installing to a Raspberry Pi or another ARM machine. If you are not sure which version of Fedora you are using, run cat /etc/os-release.

To actually install the package run the following command(s), replacing overte-server_REST-OF-PACKAGE-NAME_x86_64.rpm with the file name of whatever package you are trying to install:

sudo su  # This may or may not be needed.
yum update && rpm -i ./overte-server_REST-OF-PACKAGE-NAME_x86_64.rpm

You can run these same commands on an existing Overte domain to upgrade it if the original domain was installed using the package.

Docker

If you do not see your distribution listed here, you may try our Docker images, available for both amd64 and aarch64.

Go to whichever folder you want the Overte server to save its logs and files to, and run the following to start the container:

docker run -d --name overte-server -p 40100-40102:40100-40102 -p 40100-40102:40100-40102/udp -p 48000-48006:48000-48006/udp -v $(pwd)/logs:/var/log -v $(pwd)/data:/root/.local/share/Overte --restart unless-stopped overte/overte-server:latest

Keep in mind that the ports currently cannot be changed using Overte's Docker image. Doing so will cause connectivity issues for some people (but may work fine for others).

The container restarts automatically when the host machine is restarted.

Since the ports cannot be changed without modifying the container, it isn't currently feasible to run multiple Overte servers on one machine using Docker.

Configuración

Los paquetes de instalación crearán un dominio en la ubicación del puerto predeterminado y configurarán un servicio para que siga funcionando en esa máquina.

Para obtener la lista de puertos de red que deberás abrir y administrar, consulta aquí.

Conecta un navegador web al servidor en el puerto 40100. (Si estás en la máquina en la que se ejecuta el servidor, sería http://localhost:40100) Complete el asistente de configuración inicial y deberías tener un dominio en funcionamiento.

Archivos y Configuración del Servidor

Los archivos del programa se instalan en /opt/overte:

  • /opt/overte contiene los ejecutables

  • /opt/overte/lib contiene las bibliotecas necesarias para el funcionamiento

  • /opt/overte/plugins se utiliza actualmente para códecs de audio

  • /opt/overte/resources se requiere para el sitio web administrativo

Los ejecutables en esta carpeta (con exclusión de new-server) no se pueden iniciar desde el símbolo del sistema sin configurar primero LD_LIBRARY_PATH=/opt/overte/lib.

El archivo /etc/opt/overte/default.conf contiene las variables de entorno necesarias para ejecutar el dominio.

Todo el contenido se almacena bajo /var/lib/overte/default. Todos los archivos debajo de /var/lib/overte son propiedad del usuario overte, que también es el usuario que ejecuta todos los procesos relacionados con el dominio.

Servicios

Los paquetes de instalación configuran los siguientes servicios de systemd para administrar el dominio de Overte:

  • overte-domain-server@default.service: Administra el servidor de dominio central

  • overte-assignment-client@default.service: Genera y administra los clientes de asignación

  • overte-server@default.target: Controla el inicio y el apagado de los servicios anteriores

El servicio overte-server@default.target es el único que está configurado para iniciarse automáticamente. Iniciarlo o detenerlo hará que los otros dos servicios se caigan.

Los dos primeros servicios registran una gran cantidad de datos en su diario de servicio. Comprobando sus registros (por medio de systemctl status) es una buena manera de asegurarse de que funcionan correctamente.

Dominios Múltiples

El paquete de instalación está configurado para permitir que múltiples dominios se ejecuten en un solo servidor en diferentes números de puerto. Se pueden crear nuevos servidores usando el siguiente comando:

/opt/overte/new-server <name> <base-port>

donde name es una palabra utilizada para nombrar y administrar el dominio y base-port debe ser el primero de un rango de cuatro números de puerto contiguos que no se superpongan con ningún otro uso en el sistema.

Suponiendo que hayas creado un nuevo servidor con el nombre my-server-two, esto configuraría lo siguiente:

  • Variables de entorno en /etc/opt/overte/my-server-two.conf

  • Content stored in /var/lib/overte/my-server-two

  • Servicios lanzados como overte-domain-server@my-server-two.service, overte-assignment-client@my-server-two.service, and overte-server@my-server-two.target

Eliminando el servidor Overte

Desinstalar el paquete.

# Ubuntu/Debian
# Note: 'apt-get purge' will remove configuration files as well. Use 'apt-get remove' to keep them.
sudo apt-get purge overte-server
# Fedora/Rocky Linux
sudo yum remove overte-server
# Docker
docker container rm overte-server

Eliminación de un Dominio de una Instalación Múltiple de Dominios

Encuentra el nombre del dominio que quieres eliminar.

sudo ls ~overte

Elije el nombre del dominio que desees eliminar de la lista y luego detenlo.

sudo systemctl stop overte-server@<INSERT NAME HERE>.target

Deshabilita el servicio para el dominio.

sudo systemctl disable overte-server@<INSERT NAME HERE>.target

Quita las variables de entorno asociadas.

sudo rm /etc/opt/overte/<INSERT NAME HERE>.conf

Elimina todos los datos y configuraciones.

sudo rm -rf ~overte/<INSERT NAME HERE>
sudo rm -rf /var/lib/overte/<INSERT NAME HERE>

Servicios Legacy

Hay una serie de ajustes que se realizan en la configuración por defecto para simplificar el almacenamiento y la capacidad de ejecutar varios dominios en un servidor. En caso de que desees eliminar esta lógica y ejecutar los servidores más parecido a cómo se ejecutaría un servidor Overte compilado desde la fuente, esto se proporciona como una opción.

  • Los Servicios de Systemd nombrados como overte-domain-server.service, overte-assignment-client.service y overte-server.target (sin el @name) tienen una configuración simplificada

  • No se proporciona ningún archivo para especificar variables de entorno para el servidor

  • El contenido será almacenado en /var/lib/overte/.local