Pular para o conteúdo
Octoboard Documentação

Servidor Linux

Instale o octoboardd, o programa de servidor do Octoboard (o app o chama de daemon), em um servidor Linux sem root. Acesse-o pelo app para macOS ou Windows, ou por um navegador, sempre por SSH.

Para x86_64 e aarch64, em qualquer distribuição.

  • Um servidor Linux em que você possa fazer login por SSH. SSH é uma forma segura de fazer login em outra máquina e digitar comandos nela. O provedor do servidor informa o endereço dele e o seu nome de usuário.
  • O app Octoboard no seu próprio computador, para macOS ou Windows, se você quiser trabalhar no app para desktop (recomendado).

Para fazer login, abra o Terminal (macOS) ou o PowerShell (Windows) no seu próprio computador e execute o comando abaixo, com o seu nome de usuário no lugar de <you> e o endereço do servidor no lugar de <server>. Na primeira vez, responda yes quando ele perguntar se deve confiar no servidor.

Terminal window
ssh <you>@<server>

Os passos 1 e 2 abaixo são executados no servidor, nessa janela em que você fez login.

  1. Instale o octoboardd no servidor.

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

    Ele imprime uma linha que começa com Installed octoboardd.

  2. Inicie-o no servidor.

    Terminal window
    octoboardd start

    Ele imprime uma linha que começa com Octoboard started.

  3. Conecte-se a ele a partir do seu próprio computador, de uma de duas formas:

    • Pelo app para desktop (recomendado): siga Conectar a um servidor Linux no guia de SSH.

    • Por um navegador: execute isto no servidor.

      Terminal window
      octoboardd address

      Ele imprime duas coisas: um endereço de navegador, que começa com http://127.0.0.1:, e um comando ssh. No seu próprio computador, copie o comando ssh, substitua <server> pelo endereço do servidor (o endereço IP ou o nome que você usa para fazer login nele) e execute-o no Terminal ou no PowerShell. Ele pode pedir a sua senha e depois não mostra mais nada; isso é normal. Deixe essa janela aberta: fechá-la corta a conexão. Depois, abra o endereço impresso no navegador.

Você saberá que funcionou quando o Octoboard abrir na nova janela do app para desktop ou na aba do navegador.

Se a instalação disser que uma pasta terminada em .local/bin (por exemplo, /home/<you>/.local/bin) não está no seu PATH, o shell não consegue encontrar o octoboardd pelo nome. Execute-o pelo caminho completo que a instalação imprimiu ou adicione ~/.local/bin ao seu PATH (por exemplo, em ~/.profile) e faça login de novo.

Mantê-lo em execução depois de sair ou reiniciar

Seção intitulada “Mantê-lo em execução depois de sair ou reiniciar”

Iniciado com octoboardd start, o octoboardd para quando o servidor reinicia e nada o inicia de novo por conta própria: execute octoboardd start outra vez ou conecte-se pelo app para desktop, que se oferece para iniciá-lo para você. Alguns servidores também o encerram quando você sai da sessão.

Para que ele inicie sempre que o servidor iniciar e continue em execução depois que você sair, instale-o como um serviço:

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

Isso instala o programa, configura-o como um serviço de usuário do systemd e o inicia. Em seguida, ativa o lingering, que permite que seus serviços sejam executados enquanto você não está conectado. Se ele disser que não conseguiu, execute isto uma vez (pode ser necessário usar sudo):

Terminal window
loginctl enable-linger "$USER"

A porta padrão é 3369. Para usar outra, adicione --port <port> ao final do comando do serviço ou de octoboardd start.

O Octoboard nunca se atualiza sozinho: quando houver uma nova versão, o navegador avisa e você escolhe quando instalá-la. Depois que a nova versão estiver instalada, o Octoboard reinicia nela por conta própria quando nenhuma sessão for interrompida; se alguma for, ele as lista e pergunta antes.

  • No navegador: selecione Baixar e instalar onde aparecer o aviso de que há uma nova versão.

  • No servidor: execute este comando.

    Terminal window
    octoboardd update

    Se ele perguntar se deve reiniciar agora, responda y para reiniciar ou pressione Enter para manter a versão antiga em execução por enquanto. Para reiniciar depois, execute octoboardd restart.

Se o octoboardd update disser que não consegue substituir o programa, por exemplo porque ele foi instalado em um lugar onde você não pode gravar, execute de novo o comando de instalação (ou o comando do serviço). Ele reinicia da mesma forma quando for seguro e, caso contrário, diz para você executar octoboardd restart.

Arquivo x86_64 Arquivo aarch64 Todas as versões anteriores