Saltar a contenido

La forma más sencilla de instalar Netsocs en Linux o Mac es mediante Docker.

Requisitos

Pasos para la instalación

  1. Asegúrate de que Docker Engine esté en ejecución. Para esto, en la esquina inferior izquierda de la pantalla verás un texto indicando que Docker está en ejecución.

  2. Descarga el archivo zip o tar.gz de la versión que deseas instalar directamente desde nuestra página de releases. Allí encontrarás todas las versiones disponibles para descargar. Una vez ubicada la versión que deseas instalar, descárgala.

  3. Una vez descargado el archivo, extrae la carpeta que contiene el archivo comprimido y abre el archivo llamado .env. Este archivo contiene las diferentes configuraciones que puedes realizar para tu instalación. La configuración mínima es la dirección IP o nombre de dominio de tu servidor. Puedes abrir el archivo con cualquier editor de texto.

    Artículos de ayuda:

  4. En la primera línea del archivo .env puedes configurar el nombre de dominio de tu servidor en la variable HTTP_HOSTNAME. El valor por defecto es https://192.168.1.100. Asegúrate de mantener el https:// al inicio.

    No uses localhost ni 127.0.0.1

    Es importante que no uses localhost o 127.0.0.1 como valor para la variable HTTP_HOSTNAME, ya que Netsocs no funcionará correctamente.

  5. Abre una terminal y navega hasta la carpeta donde extrajiste los archivos.

  6. Ejecuta el comando docker compose up -d y presiona Enter. Esto iniciará los contenedores de Netsocs en segundo plano.

    Después de unos minutos, podrás acceder a la interfaz de Netsocs desde tu navegador web utilizando la dirección IP o el nombre de dominio que configuraste previamente en el archivo .env.

    Para monitorear el estado de los contenedores, puedes utilizar Docker Desktop. Dirígete a la pestaña Containers, donde podrás verificar su estado, reiniciarlos, consultar los logs y realizar otras acciones de gestión.

  7. Cuando el proceso finalice, verás un mensaje indicando que los contenedores se han iniciado correctamente.

    • Punto de acceso: La URL principal de Netsocs se muestra en "Access URLs" (ej., Main: https://172.20.80.1). Presiona Ctrl + Clic (o Cmd + Clic en Mac) en la URL para abrirla en tu navegador.
    • Credenciales: Las credenciales de administrador de Netsocs se muestran al final — usuario admin y una contraseña aleatoria generada para tu instalación.

  8. Antes de finalizar, debes aceptar el certificado auto-generado. Cuando accedas por primera vez a la URL de Netsocs en tu navegador, aparecerá una advertencia de seguridad porque el certificado es auto-firmado. Acepta el certificado para continuar y completar la configuración.

    El cambio de hostname requiere reinstalar el certificado

    Si cambias la variable HTTP_HOSTNAME después de la instalación, debes reinstalar el certificado en esta máquina y en cualquier otro cliente que lo tuviera instalado.

    Al final, se mostrarán instrucciones sobre cómo instalar el certificado en otros clientes (otras PCs) para que puedan acceder a Netsocs sin advertencias de seguridad.

  • Agregar tu primer dispositivo

    Agrega tu primer dispositivo a Netsocs.

    Seguir

  • Configurar un site remoto

    Configura un sitio remoto para acceder a Netsocs desde cualquier lugar.

    Seguir

Problemas comunes

Error response from daemon: ports are not available

Si al iniciar los contenedores aparece el siguiente error:

Error response from daemon: ports are not available

Esto significa que el puerto 80 o 443 ya está en uso por otro programa. Debes asegurarte de que ningún otro programa esté usando estos puertos.