Como hospedar o HarnessRouter com uma API
Hospede Codex, Claude Code e Hermes em uma API própria: veja o Docker exato, o bind em loopback, a troca do login inicial e o acesso com TLS.
O que o HarnessRouter elimina
Você hospeda o HarnessRouter Community Edition no seu próprio servidor para colocar uma API na frente de vários agent harnesses. Um agent harness é o programa de linha de comandos que executa um modelo num ciclo: mantém uma sessão, edita ficheiros, executa comandos e transmite o progresso para quem solicitou o trabalho. Codex, Claude Code e Hermes fazem esse trabalho, e cada um tem o seu próprio método de instalação, o seu próprio formato de credenciais e a sua própria definição de sessão. O HarnessRouter executa todos dentro de um único contentor e disponibiliza um único endpoint HTTP, um único login e um único armazenamento de segredos.
Essa é a ideia completa, e vale a pena explicitar o custo. Você está a adicionar um contentor, um login, um volume e um processo de atualização ao seu servidor para transformar vários componentes numa única unidade. Se hoje executa exatamente um harness, esta configuração é pior do que instalar esse harness diretamente. Essa é a contrapartida analisada na última secção, por isso leia-a antes de fazer o deployment.
Tudo o que segue foi verificado com a tag de imagem 0.5.5, obtida em 19 August 2026. O projeto publica novas tags na maioria dos dias, por isso confirme a tag que realmente executa em vez de confiar nesta página daqui a um mês. Em 8 November 2026, esta página foi novamente verificada com base na documentação e no código-fonte atuais do projeto. Nessa altura, latest apontava para 0.38.5, e os pontos em que as versões atuais se comportam de forma diferente estão identificados. Os comandos vêm do repositório do projeto em github.com/HarnessRouter/harnessrouter. Estavam no README em 0.5.5; os detalhes da configuração estão agora em docs/self-hosting-guide.md, no mesmo repositório.
O que o Unified Harness Protocol realmente é
O HarnessRouter implementa o Unified Harness Protocol (UHP), publicado em unifiedharnessprotocol.org. O UHP descreve como um produto inicia uma tarefa num harness, acompanha a tarefa enquanto ela é executada, gere sessões e ficheiros e comunica falhas. A especificação é versionada por data. A versão em vigor em 19 August 2026 tinha a data 2026-08-11. Em 8 November 2026, o site lista 2026-10-19 como a versão atual e continua a classificá-la como um padrão em rascunho, "estável o suficiente para servir de base, com versões para poder evoluir com segurança".
Leia com atenção a expressão "padrão aberto". A mesma empresa escreve a especificação, a implementação de referência e o conjunto de testes de conformidade que determina quem está em conformidade. As regras de governação do projeto dizem que nenhuma alteração é integrada sem atualizar os três componentes em conjunto. Em 9 November 2026, a página inicial do protocolo descreve esse conjunto como tendo 110 verificações executáveis, enquanto a página de conformidade indica 101 e a execução de referência registada no guia de self-hosting, com data de 4 September 2026, passou 64. Portanto, as contagens publicadas não coincidem. O changelog do projeto data de 4 November 2026 as seis verificações adicionais de branching. Isso é normal num protocolo tão recente, e a licença Apache-2.0 significa que pode fazer fork de qualquer parte dele. Também significa que o UHP ainda não é um padrão adotado por vários fornecedores. Trate-o como um protocolo emergente: útil, sujeito a alterações e algo que o seu próprio código deve conseguir deixar de usar sem uma reescrita.
O que é necessário antes de começar
Docker e aproximadamente 4 GB de espaço livre em disco. Também é necessária uma chave de API de um fornecedor de modelos que já tenha contratado. O download da imagem ocupa cerca de 700 MB, e o restante do espaço em disco é usado pelas CLIs dos agentes e pelos workspaces onde escrevem. A imagem não inclui nenhum modelo nem uma chave de avaliação, por isso as tarefas falham até ligar um fornecedor. O próprio HarnessRouter está licenciado sob Apache-2.0. As CLIs dos agentes continuam sujeitas às respetivas licenças e termos, que não são substituídos pela licença do repositório; são obtidas no primeiro arranque, em vez de serem incluídas na imagem.
Hospede o HarnessRouter com um único docker run
docker pull harnessrouter/harnessrouter
docker run -d --name harnessrouter \
-p 127.0.0.1:3000:3000 \
-v harnessrouter:/data \
harnessrouter/harnessrouterEm seguida, acompanhe o arranque do contentor. O primeiro arranque é lento, e os logs explicam o motivo.
docker logs -f harnessrouterDurante o arranque, verá linhas semelhantes a estas:
installing Claude Code (Anthropic's terms apply)…
installing Codex (Apache-2.0)…
installing Hermes (check its upstream license before use)…Aguarde por ready on :3000. O guia atual mede aproximadamente meio minuto a partir do momento em que docker run devolve o prompt, e não a partir dessa linha; se http://localhost:3000 não responder imediatamente depois da linha de pronto, tente novamente após alguns segundos. As CLIs instaladas ficam em cache no volume, por isso os arranques seguintes são normalmente muito mais rápidos. No entanto, um backend adicionado mais tarde, ou um backend cuja instalação tenha falhado anteriormente, ainda pode desencadear uma nova instalação.
Deste download resultam dois factos, e ambos são importantes num VPS. Primeiro, o primeiro arranque precisa de acesso à rede de saída. A imagem não é autónoma, por isso um sistema atrás de um filtro de saída, ou sem uma rota para fora, não consegue obter as CLIs dos agentes. Tanto 0.5.5 como as versões atuais tratam as instalações falhadas como não fatais e indicam-nas no log. Verifique, portanto, quais são os backends omitidos pela linha backends available:. Segundo, está a instalar software de terceiros ao abrigo de termos de terceiros. O Claude Code é disponibilizado ao abrigo dos termos da Anthropic, e o Hermes ao abrigo dos termos definidos pelo respetivo projeto upstream. Consulte ambos antes de usar o software comercialmente.
-v harnessrouter:/data cria um volume Docker com nome. Todos os dados persistentes ficam em /data: as bases de dados SQLite, os ficheiros armazenados, o armazenamento de segredos e os workspaces dos agentes. Se eliminar esse volume, elimina a instância, incluindo as chaves dos fornecedores e todas as transcrições. Faça o backup com o contentor parado, porque copiar uma base de dados SQLite enquanto está a ser gravada pode produzir um ficheiro que não abre. A mesma disciplina de parar e só depois copiar aplica-se a todos os contentores com estado no servidor, embora os detalhes variem consoante o serviço, já que PhotoPrism e Immich precisam dos seus próprios comandos de backup.
docker stop harnessrouter
docker run --rm -v harnessrouter:/data -v "$PWD":/backup alpine \
tar czf /backup/harnessrouter-data.tgz -C / data
docker start harnessrouterA variante do Compose e a linha que deve alterar
O repositório inclui um ficheiro Compose. Atualmente, ele publica "127.0.0.1:3000:3000", associando a porta do host ao loopback. O ficheiro 0.5.5 publicado "3000:3000"; altere essa linha se estiver a usar o ficheiro antigo num servidor público.
services:
harnessrouter:
image: harnessrouter/harnessrouter:0.5.5
ports:
- "127.0.0.1:3000:3000"
env_file:
- .env
volumes:
- harnessrouter-data:/data
restart: unless-stopped
volumes:
harnessrouter-data:Há uma diferença em relação ao upstream atual: é usada uma tag de versão fixa em vez de latest. Fixar a versão é importante porque as releases mudam rapidamente: o Docker Hub indicava que 0.38.4 e 0.38.5 tinham sido publicados nas 24 horas anteriores quando foi consultado em 8 November 2026. Um runtime de agente que muda sem aviso é difícil de depurar. Fixe a release atual em vez de copiar 0.5.5 desta página; em 9 November 2026, essa release era 0.40.0. Em seguida, copie o ficheiro de ambiente, restrinja as respetivas permissões e inicie o serviço.
cp .env.example .env
chmod 600 .env
docker compose up -d
docker compose logs -f.env armazena a chave do seu fornecedor em texto simples, por isso o modo 600 é o mínimo. Se o subcomando docker compose não lhe for familiar, a folha de consulta dos comandos do Docker Compose apresenta os verbos usados no dia a dia.
Por que a porta é publicada em 127.0.0.1 e não em 0.0.0.0
-p 3000:3000 publica a porta em todas as interfaces que o host tem por padrão. -p 127.0.0.1:3000:3000 publica a porta do host na interface de loopback. As versões do Docker anteriores a 28.0.0 permitem que hosts no mesmo segmento L2 alcancem portas publicadas em localhost, e o encaminhamento direto ativado explicitamente pode expor a porta do contentor apesar do mapeamento da porta do host para loopback. O contentor escuta na porta 3000 por padrão, configurável através de PORT. Altere o número da porta do lado esquerdo para evitar um conflito com uma porta do host. Verifique o resultado:
docker port harnessrouter
sudo ss -ltnp | grep 3000A apresentação de ss por 127.0.0.1:3000 está correta. 0.0.0.0:3000 significa que a consola está associada a todas as interfaces IPv4; o acesso pela Internet pública continua a depender do encaminhamento e da filtragem. Neste caso, isso é mais grave do que na maioria das aplicações auto-hospedadas, porque a consola cria ambientes de execução, lê todas as transcrições, executa agentes e fornece a esses agentes uma shell e um sistema de ficheiros real no respetivo workspace. Também mantém a chave do provider que ligou. Qualquer pessoa que alcance uma consola sem proteção pode ler o seu trabalho, executar comandos e gastar a sua chave.
Uma regra de negação do ufw não impede isto. O Docker desvia o tráfego dos contentores publicados através das suas próprias regras antes das chains geridas por ufw. Por isso, sudo ufw status mostrar uma porta como negada não prova que a porta publicada esteja bloqueada. Teste a partir de outra máquina, não a partir da VPS, caso contrário não estará a testar nada. Esta é a mesma lição de executar o dsh sem interface numérica na porta 3080: associe o serviço à interface de loopback e decida depois, de forma deliberada, como irá aceder-lhe.
Altere o início de sessão predefinido antes de qualquer outra coisa
Inicie sessão em http://localhost:3000 com o nome de utilizador harnessrouter e a palavra-passe inicial gerada pela sua instância. Leia-a com:
docker exec harnessrouter cat /data/selfhost-initial-passwordA palavra-passe partilhada harnessrouter funcionava em 0.5.5; as instalações atuais não aceitam esse valor predefinido publicado.
Altere-a na página Profile ou defina-a no arranque para uma implementação automatizada. HR_AUTH_USER e HR_AUTH_PASSWORD fornecem as credenciais iniciais; as credenciais guardadas em Profile têm precedência.
docker run -d --name harnessrouter \
-p 127.0.0.1:3000:3000 \
-v harnessrouter:/data \
-e HR_AUTH_USER='you' \
-e HR_AUTH_PASSWORD='the-password-you-chose' \
harnessrouter/harnessrouterNão existe uma mensagem de reposição para o início de sessão local do Console. Se perder a palavra-passe, elimine o ficheiro de autenticação no volume e reinicie. Em seguida, inicie sessão com HR_AUTH_USER e HR_AUTH_PASSWORD configurados ou com a palavra-passe inicial gerada, caso não tenha fornecido credenciais próprias.
docker stop harnessrouter
docker run --rm -v harnessrouter:/data alpine rm -f /data/selfhost-auth.json
docker start harnessrouterHR_AUTH_DISABLED=1 remove completamente a proteção de início de sessão. O guia de self-hosting considera essa opção "apenas razoável numa máquina à qual mais ninguém consiga aceder". Um VPS com um endereço IP público não é essa máquina. Por isso, mantenha a proteção ativada, exceto se estiver a executar isto num portátil.
Verifique a versão, porque as antigas não tinham qualquer barreira
Esta é a parte que deve levar a sério. As versões 0.1.x e 0.2.0 foram lançadas sem qualquer barreira de autenticação: qualquer pessoa que conseguisse aceder à porta 3000 já estava dentro da consola. 0.3.0 foi a primeira versão lançada com início de sessão. Esta página registou pela última vez essas tags antigas como publicadas e disponíveis para pull em 12 October 2026; a disponibilidade atual não foi confirmada em 8 November 2026.
Em 19 August 2026, a tag publicada mais recente era 0.5.5, datada de 18 August 2026. Em 8 November 2026, latest apontava para 0.38.5. Verifique o que tem e compare-o com a lista de tags no Docker Hub:
docker image ls harnessrouter/harnessrouterTudo o que for inferior a 0.3.0 deve ser substituído agora, não agendado. As versões antigas com a palavra-passe predefinida partilhada ainda precisam que ela seja alterada; as instalações atuais geram uma palavra-passe inicial e pedem-lhe que escolha a sua. Não trate os números de versão desta página como atuais. Eram válidos nas datas indicadas, e este projeto lança versões rapidamente.
Ligar um provider
Nada é executado até ligar um model provider. Adicione um em Bring your own key, no menu da conta, ou passe-o a docker run no ambiente. O valor é JSON, por isso coloque-o entre aspas na shell:
-e HR_SECRET_GLOBAL_HARNESS_CONN_ANTHROPIC='{"name":"anthropic","provider":"anthropic","api_key":"sk-ant-…"}'.env.example define uma variável de ligação para cada família de providers: HR_SECRET_GLOBAL_HARNESS_CONN_ANTHROPIC para o backend claude-code, HR_SECRET_GLOBAL_HARNESS_CONN_OPENAI para o backend codex, HR_SECRET_GLOBAL_HARNESS_CONN_GOOGLE para o backend gemini e HR_SECRET_GLOBAL_HARNESS_CONN_CUSTOM para qualquer endpoint compatível com OpenAI, que é onde deve ligar um agregador ou o seu próprio servidor de inferência. As variáveis HR_SECRET_GLOBAL_HARNESS_POLICY_CLAUDE, HR_SECRET_GLOBAL_HARNESS_POLICY_CODEX e HR_SECRET_GLOBAL_HARNESS_POLICY_HERMES correspondentes indicam qual ligação cada backend usa por predefinição, e existe uma variável de política para cada backend. HR_SECRET_KEY é algo separado. As releases atuais encriptam as credenciais armazenadas com esta variável e geram uma chave em /data/secret-key quando não fornece uma. Mantenha a mesma chave entre reinícios e upgrades. Para a manter separada dos dados numa instância existente, defina HR_SECRET_KEY com o valor desse ficheiro e elimine o ficheiro.
HR_BACKENDS seleciona os backends que serão instalados e carregados, como em HR_BACKENDS=claude,codex,hermes. Se ficar por definir, as releases atuais instalam uma lista predefinida muito maior, com 30 backends, desde claude, codex e hermes até opencode, gemini, goose e outros. Reduzir a lista poupa espaço em disco e tempo no primeiro arranque. O guia atual de self-hosting diz para "deixar qualquer um deles fora de HR_BACKENDS se não o for usar", e o próprio exemplo enxuto é HR_BACKENDS=opencode, que exclui completamente o Hermes. Um backend que não consiga ser instalado não interrompe o serviço: os restantes continuam a funcionar, e uma tarefa num backend que não foi instalado é recusada como "not installed", enquanto o log do contentor identifica a instalação que falhou. O README de 0.5.5 tinha um problema conhecido: deixar hermes de fora fazia o contentor terminar imediatamente com o estado 1 e sem mensagem de erro. No entanto, o entrypoint dessa tag já corrige a falha; os comentários descrevem a implementação anterior. Se o Hermes for o único harness que pretende usar, executar o agente Hermes no seu próprio VPS é uma implementação mais pequena.
Ligue à API sem utilizar a consola
A consola é opcional. A mesma API serve ambos e utiliza um contrato no estilo Responses. Inicie sessão primeiro para obter um cookie de sessão:
curl -c hr.cookies http://localhost:3000/api/selfhost/login \
-H 'content-type: application/json' \
-d '{"username":"harnessrouter","password":"your-password"}'Em seguida, envie uma tarefa, indicando o harness em metadata.harness_id e um modelo que o seu fornecedor ligado disponibilize efetivamente:
curl -s -b hr.cookies http://localhost:3000/api/harness/v1/responses \
-H 'content-type: application/json' \
-d '{"input":"Reply with exactly this and nothing else: it works.",
"metadata":{"harness_id":"codex"},
"model":"gpt-5.4-mini",
"stream":false}'Um objeto JSON que contenha um bloco de saída e uma contagem de tokens significa que o harness foi executado. Alterar harness_id de codex para claude-code envia o mesmo pedido para outro harness, e essa troca é precisamente a razão de existência deste software. Repare que o ID é claude-code, embora o nome do backend seja HR_BACKENDS e a variável de política seja claude. A ligação personalizada acima permite apontar um harness para um endpoint compatível com OpenAI que já aloja, tal como está configurado um harness DeepSeek autoalojado numa VPS.
O fluxo com cookie de sessão continua a ser suportado para depuração local. Num backend de produto, a documentação atual recomenda criar uma chave de API do HarnessRouter em API Keys e enviá-la como um token Bearer, em vez de manter uma sessão da Console.
Aceda a partir do seu laptop sem publicar uma porta
Há duas formas, e nenhuma delas expõe diretamente uma porta em 0.0.0.0.
Um túnel SSH é a opção mais simples e não requer qualquer instalação no servidor. Ele encaminha uma porta local do seu computador para o loopback no VPS.
ssh -N -L 3000:127.0.0.1:3000 you@your-vpsDeixe o túnel em execução e abra http://localhost:3000 no browser. Se o SSH apresentar bind: Address already in use, outro processo no seu laptop já está a usar a porta 3000. Nesse caso, escolha outra porta local com -L 3100:127.0.0.1:3000 e aceda à porta 3100.
Um reverse proxy com terminação TLS é a solução quando outras pessoas precisam de acesso. O proxy gere o certificado TLS (transport layer security) e encaminha os pedidos para o loopback. O guia de self-hosting fornece uma configuração do Caddy:
console.example.com {
encode zstd gzip
reverse_proxy 127.0.0.1:3000 {
flush_interval -1 # agent turns stream for minutes; never buffer them
}
}flush_interval -1 desativa explicitamente o buffering das respostas do Caddy. O Caddy já envia imediatamente as respostas text/event-stream sem essa diretiva. O Agent transforma tokens de stream durante minutos. Se o proxy armazenar a resposta em buffer, retém esses tokens até o turno terminar. A consola parece bloqueada e depois apresenta tudo de uma só vez. O equivalente no Nginx é proxy_buffering off; dentro do bloco location. Seja qual for a opção escolhida, mantenha o nome DNS apontado para o proxy e o container no loopback. Comparação entre Nginx, Caddy e Traefik como reverse proxy explica qual se adequa melhor ao seu servidor.
Execute com um utilizador próprio, não como root
O daemon do Docker é executado como root, e pertencer ao grupo docker equivale a ter permissões de root, porque um membro pode iniciar um contentor que monte o sistema de ficheiros do host. Por isso, “adicionar a equipa ao grupo docker” concede acesso root ao servidor que guarda a chave do fornecedor.
A versão simples: crie uma conta de serviço que seja proprietária do ficheiro Compose e de .env, e mantenha esses ficheiros fora de qualquer diretório pessoal partilhado.
sudo adduser --disabled-password --gecos "" harness
sudo install -d -o harness -g harness -m 750 /srv/harnessrouterNão tente fazer isso adicionando --user a docker run ou user: ao ficheiro Compose. O guia atual indica que o contentor tem de ser iniciado como root e, a partir de 0.8.2, recusa iniciar de outra forma, registando uma única linha no log que explica o motivo.
A opção mais segura é o Docker rootless, em que o próprio daemon é executado por esse utilizador sem privilégios. É necessário o pacote uidmap para newuidmap e newgidmap, além de pelo menos 65536 UIDs subordinados em /etc/subuid e /etc/subgid para o utilizador. uidmap está disponível no arquivo do Ubuntu, mas docker-ce-rootless-extras não está: é distribuído pelo repositório apt do próprio Docker em download.docker.com, que a instalação do Docker Engine adiciona. Se o engine não tiver sido instalado a partir desse repositório, grep -rl download.docker.com /etc/apt/sources.list.d/ não apresenta qualquer resultado e a instalação abaixo não encontrará o pacote.
sudo apt install -y uidmap docker-ce-rootless-extras
sudo loginctl enable-linger harness
sudo -iu harness
dockerd-rootless-setuptool.sh install
export DOCKER_HOST=unix:///run/user/$(id -u)/docker.sock
systemctl --user enable --now dockerloginctl enable-linger mantém a instância systemd do utilizador em execução depois do logout e inicia-a no boot. Confirme o resultado com docker info, que apresenta rootless em Security Options. O modo rootless não pode associar portas abaixo de 1024 sem configuração adicional. Isso não é relevante aqui, porque a porta 3000 está acima desse limite. A configuração da própria conta é abordada em criar utilizadores com o princípio do menor privilégio num VPS.
O que falha e o que verá
O contentor termina um segundo depois de arrancar e os logs estão vazios. docker ps -a mostra Exited (1). Um entrypoint anterior falhava quando HR_BACKENDS omitia hermes, mas 0.5.5 já contém a correção, embora o respetivo README ainda liste o problema. Não diagnostique essa falha apenas pelo estado de saída. Numa tag recente, leia a última linha de docker logs: a partir de 0.8.2, um contentor iniciado com --user termina com uma linha a indicar que tem de arrancar como root.
O primeiro arranque nunca termina. O log para depois de uma linha installing e ready on :3000 nunca aparece. Verifique se o servidor consegue aceder à rede para obter as CLIs dos agentes, porque elas não estão incluídas na imagem. Tanto 0.5.5 como as versões atuais toleram falhas de instalação concluídas, identificam as instalações falhadas no log e deixam-nas de fora da linha backends available:. Corrija a rota de saída ou as definições do proxy e reinicie.
A consola carrega e todas as tarefas falham. Não existe nenhum provider ligado. A imagem não inclui nenhum modelo nem um nível gratuito, por isso uma instância nova pode permitir iniciar sessão e, ainda assim, não executar nada.
A consola bloqueia a meio da resposta atrás de um proxy. O resultado aparece num único bloco quando a interação termina. Isso é buffering da resposta. Defina flush_interval -1 no Caddy ou proxy_buffering off; no Nginx.
Não consegue aceder a partir do portátil e o túnel está ativo. Execute docker port harnessrouter no servidor. Se não mostrar nada, o contentor não publica nenhuma porta. Verifique o mapeamento de portas e o modo de rede.
Vale a pena executar isto?
Vale a pena executar o HarnessRouter se realmente utiliza mais do que um harness e quer um endpoint e um armazenamento de credenciais em vez de três de cada. Também vale a pena executá-lo se estiver a criar um produto sobre esta base e quiser que o harness seja um valor de configuração, em vez de exigir uma reescrita. É isso que o UHP oferece, com a ressalva acima sobre a pouca maturidade do protocolo.
Não vale a pena executá-lo se utiliza um único harness. Instalar esse CLI no servidor envolve menos componentes, e não há um login entre si e o harness. Também não é a opção adequada se pretende vários agentes a colaborar numa única tarefa, em vez de uma API à frente de vários harnesses. Esse é um caso de utilização para outra ferramenta: consulte um harness multiagente, como o Omnigent. Em qualquer dos casos, as regras de implementação não mudam. Bind em loopback, palavra-passe alterada, uma release atual fixada e um utilizador próprio.
FAQ
É seguro publicar o HarnessRouter na porta 3000?
Não. A consola cria harnesses, lê todas as transcrições, executa agentes com acesso à shell e ao sistema de ficheiros e guarda a chave do fornecedor que ligou. Uma consola sem proteção expõe tudo isso. Publique na interface de loopback com -p 127.0.0.1:3000:3000 e aceda através de um túnel SSH ou de um reverse proxy com terminação TLS. Uma regra de negação ufw não é suficiente por si só: o Docker desvia o tráfego publicado dos contentores antes das cadeias geridas por ufw. Verifique com sudo ss -ltnp | grep 3000, que deve imprimir 127.0.0.1:3000, e teste o acesso a partir de outra máquina. Use o Docker 28.0.0 ou posterior para evitar a exposição antiga do localhost na mesma L2 e confirme que o encaminhamento direto não foi ativado.
Que versão do HarnessRouter adicionou o bloqueio de início de sessão?
0.3.0. As versões 0.1.x e 0.2.0 foram lançadas sem qualquer autenticação, por isso quem as executa depende apenas de ninguém encontrar a porta. Esta página registou pela última vez essas tags como publicadas e disponíveis para pull em 12 October 2026; a disponibilidade atual não foi confirmada em 8 November 2026. Em 19 August 2026, a tag mais recente era 0.5.5, datada de 18 August 2026; em 8 November 2026, latest apontava para 0.38.5. Execute docker image ls harnessrouter/harnessrouter para ver o que tem, compare com a lista de tags no Docker Hub e não com esta página, e escolha a sua própria palavra-passe. As instalações atuais geram uma palavra-passe inicial em vez de aceitarem a predefinição partilhada antiga.
Porque é que o contentor termina imediatamente depois de eu definir HR_BACKENDS?
Numa versão atual, isso não deveria acontecer. O guia de self-hosting indica que deve omitir qualquer backend que não vá utilizar, e a falha na instalação de um backend não é fatal. Uma implementação anterior terminava com o estado 1 e sem mensagem de erro quando hermes era omitido, mas o código-fonte 0.5.5 já corrige essa falha, embora o README ainda a liste. Numa tag recente, leia docker logs: a partir de 0.8.2, um contentor iniciado com --user termina com uma linha a indicar que tem de arrancar como root.
O HarnessRouter precisa de acesso à Internet no primeiro arranque?
Sim. As CLIs dos agentes são obtidas no primeiro arranque, em vez de serem incluídas na imagem, e cada uma continua sujeita à sua própria licença e aos respetivos termos. Tanto 0.5.5 como as versões atuais registam as instalações falhadas no log e permitem que os outros backends arranquem. As CLIs instaladas ficam em cache no volume, por isso os arranques seguintes são normalmente mais rápidos. Ainda assim, as ferramentas dos backends e as tarefas executadas podem precisar de acesso à rede, e um backend novo ou cuja instalação tenha falhado anteriormente pode desencadear uma nova instalação.
Perdi a palavra-passe da consola. Como volto a aceder?
Não existe email de reposição para o início de sessão local da Console. Pare o contentor, elimine /data/selfhost-auth.json do volume, inicie-o novamente e inicie sessão com o seu HR_AUTH_USER e HR_AUTH_PASSWORD configurados, ou com a palavra-passe inicial gerada se não tiver fornecido uma própria. Depois, defina uma nova palavra-passe na página Profile. Com o contentor e o volume denominados harnessrouter, execute docker stop harnessrouter, depois docker run --rm -v harnessrouter:/data alpine rm -f /data/selfhost-auth.json e, em seguida, docker start harnessrouter. Leia a palavra-passe gerada com docker exec harnessrouter cat /data/selfhost-initial-password.