Ir al contenido
Octoboard Documentación

Servidor Linux

Instala octoboardd, el programa de servidor de Octoboard (la app lo llama el servicio), en un servidor Linux sin root. Accede a él desde la app para macOS o Windows, o desde un navegador, ambos por SSH.

Para x86_64 y aarch64, en cualquier distribución.

  • Un servidor Linux en el que puedas iniciar sesión por SSH. SSH es una forma segura de iniciar sesión en otra máquina y escribir comandos en ella. El proveedor del servidor te da su dirección y tu nombre de usuario.
  • La app de Octoboard en tu propio equipo, para macOS o Windows, si quieres trabajar en la app de escritorio (recomendado).

Para iniciar sesión, abre Terminal (macOS) o PowerShell (Windows) en tu propio equipo y ejecuta el comando siguiente, con tu nombre de usuario en lugar de <you> y la dirección del servidor en lugar de <server>. La primera vez, responde yes cuando pregunte si confías en el servidor.

Terminal window
ssh <you>@<server>

Los pasos 1 y 2 siguientes se ejecutan en el servidor, en esa ventana en la que ya has iniciado sesión.

  1. Instala octoboardd en el servidor.

    Terminal window
    curl --proto '=https' --tlsv1.2 -fsSL https://octoboard.dev/install.sh | sh

    Muestra una línea que empieza por Installed octoboardd.

  2. Inícialo en el servidor.

    Terminal window
    octoboardd start

    Muestra una línea que empieza por Octoboard started.

  3. Conéctate desde tu propio equipo, de una de estas dos formas:

    • Desde la app de escritorio (recomendado): sigue Conectar con un servidor Linux en la guía de SSH.

    • Desde un navegador: ejecuta esto en el servidor.

      Terminal window
      octoboardd address

      Muestra dos cosas: una dirección del navegador, que empieza por http://127.0.0.1:, y un comando ssh. En tu propio equipo, copia el comando ssh, sustituye <server> por la dirección del servidor (la dirección IP o el nombre con el que inicias sesión en él) y ejecútalo en Terminal o PowerShell. Puede que pida tu contraseña y después no muestra nada más; es normal. Deja esa ventana abierta: si la cierras, se corta la conexión. Después abre en tu navegador la dirección que se mostró.

Sabrás que ha funcionado cuando Octoboard se abra en la nueva ventana de la app de escritorio o en la pestaña del navegador.

Si la instalación indica que una carpeta que termina en .local/bin (por ejemplo /home/<you>/.local/bin) no está en tu PATH, el shell no puede encontrar octoboardd por su nombre. Ejecútalo con la ruta completa que mostró la instalación, o añade ~/.local/bin a tu PATH (por ejemplo en ~/.profile) y vuelve a iniciar sesión.

Mantenerlo en marcha al cerrar sesión o reiniciar

Sección titulada «Mantenerlo en marcha al cerrar sesión o reiniciar»

Si lo inicias con octoboardd start, octoboardd se detiene cuando el servidor se reinicia y nada lo vuelve a iniciar por sí solo: ejecuta de nuevo octoboardd start o conéctate desde la app de escritorio, que se ofrece a iniciarlo por ti. Algunos servidores también lo detienen al cerrar sesión.

Para que se inicie cada vez que arranque el servidor y siga en marcha después de cerrar sesión, instálalo como servicio:

Terminal window
curl --proto '=https' --tlsv1.2 -fsSL https://octoboard.dev/install.sh | sh -s -- --service

Esto instala el programa, lo configura como servicio de usuario de systemd y lo inicia. Después activa lingering, que permite que tus servicios se ejecuten mientras no tienes una sesión abierta. Si indica que no pudo hacerlo, ejecuta esto una vez (puede que necesite sudo):

Terminal window
loginctl enable-linger "$USER"

El puerto predeterminado es 3369. Para usar otro, añade --port <port> al final del comando del servicio o de octoboardd start.

Octoboard nunca se actualiza por sí solo: cuando hay una versión nueva, el navegador te avisa y tú eliges cuándo instalarla. Una vez instalada la versión nueva, Octoboard se reinicia con ella por sí mismo cuando no se interrumpiría ninguna sesión; si se interrumpiera alguna, te las muestra y te pregunta antes.

  • En el navegador: selecciona Descargar e instalar donde indica que hay una versión nueva disponible.

  • En el servidor: ejecuta este comando.

    Terminal window
    octoboardd update

    Si pregunta si quieres reiniciar ahora, responde y para reiniciar o pulsa Intro para seguir usando por ahora la versión anterior. Para reiniciar más tarde, ejecuta octoboardd restart.

Si octoboardd update indica que no puede reemplazar el programa, por ejemplo porque se instaló en un lugar donde no puedes escribir, ejecuta de nuevo el comando de instalación (o el del servicio). Se reinicia del mismo modo cuando es seguro y, si no, te indica que ejecutes octoboardd restart.

Archivo x86_64 Archivo aarch64 Todas las versiones anteriores