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.
Antes de começar
Seção intitulada “Antes de começar”- 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.
ssh <you>@<server>Os passos 1 e 2 abaixo são executados no servidor, nessa janela em que você fez login.
Instalar
Seção intitulada “Instalar”-
Instale o octoboardd no servidor.
Terminal window curl --proto '=https' --tlsv1.2 -fsSL https://octoboard.dev/install.sh | shEle imprime uma linha que começa com
Installed octoboardd. -
Inicie-o no servidor.
Terminal window octoboardd startEle imprime uma linha que começa com
Octoboard started. -
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 addressEle imprime duas coisas: um endereço de navegador, que começa com
http://127.0.0.1:, e um comandossh. No seu próprio computador, copie o comandossh, 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 o octoboardd não for encontrado
Seção intitulada “Se o octoboardd não for encontrado”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:
curl --proto '=https' --tlsv1.2 -fsSL https://octoboard.dev/install.sh | sh -s -- --serviceIsso 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):
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.
Atualizar
Seção intitulada “Atualizar”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 updateSe ele perguntar se deve reiniciar agora, responda
ypara reiniciar ou pressione Enter para manter a versão antiga em execução por enquanto. Para reiniciar depois, executeoctoboardd 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.