Skip to main content
Acessar Studio

Instalação do Runner

Requisitos de Sistema​

Antes de instalar, verifique se o ambiente atende a todos os requisitos abaixo. Ignorar essa etapa é a causa mais comum de problemas de performance e conectividade.

Hardware​

RecursoMínimoRecomendado
Memória RAM4 GB8 GB ou mais
Armazenamento2 GB disponíveisSSD com 10 GB ou mais
ProcessadorDual-core 2 GHzQuad-core 2,5 GHz ou superior

Sistema Operacional​

Servidores e ambientes de produção:

  • Windows Server 2016, 2019 ou 2022
  • Windows 10 ou 11 (64 bits)
  • Ubuntu 20.04 LTS ou superior (somente Roberty Production Runner)

Estações de desenvolvimento:

  • Windows 10 ou 11 (64 bits)
  • macOS 12 Monterey ou superior
Windows Server 2012 R2 (ambiente legado)

O Google Chrome parou de receber atualizações para o Windows Server 2012 R2. Nesses ambientes, use o Chromium versão 109: Download do Chromium 109

Após o download, extraia o conteúdo em: C:\Program Files\Google\Chrome\Application

Softwares necessários​

SoftwareQuando é necessário
Google Chrome ou Microsoft Edge (versão mais recente)Sempre — necessário para automações web
Microsoft Office 2013 ou superiorApenas para robôs que manipulam arquivos Excel (.xlsx / .xls)

Versões disponíveis​

O Roberty oferece dois tipos de instalação, cada um com um propósito distinto. Escolha de acordo com o seu objetivo.

Roberty Studio Desktop​

Indicado para desenvolvimento e testes. Reúne em uma única aplicação o Designer — onde você cria os robôs — e o Runner, que os executa.

  • Disponível para: Windows e macOS
  • Diferencial: acesso antecipado a funcionalidades experimentais, liberadas primeiro na versão Desktop antes de chegarem ao Studio web

Roberty Production Runner​

Indicado para servidores e ambientes de produção. É uma instalação enxuta, dedicada exclusivamente à execução dos robôs, sem interface de design.

  • Disponível para: Windows e Linux
  • Ideal para: servidores em data centers, máquinas virtuais, ambientes de alta disponibilidade e execuções em escala

Como baixar​

  1. Acesse sua workspace em studio.roberty.app.
  2. No menu superior, clique em Baixar o Roberty.
  3. Escolha a versão adequada ao seu ambiente:
    • No meu computador → Roberty Studio Desktop
    • Em um servidor → Roberty Production Runner
  4. Clique em Download para iniciar o download do instalador.

Instalação no Linux​

O Roberty Production Runner está disponível para as seguintes distribuições:

  • Debian e derivados (como Ubuntu)
  • RHEL — Red Hat Enterprise Linux

Entre em contato com os nossos canais de suporte para obter as instruções de instalação do Runner para estas versões.

Instalação passo a passo​

Passo 1 — Executar o instalador​

Abra o arquivo baixado. Se o Windows exibir o aviso "O Windows protegeu o computador", siga estes passos:

  1. Clique em Mais informações.
  2. Clique em Executar mesmo assim.
Por que o Windows exibe esse aviso?

Para realizar automações, o Roberty precisa de permissões para controlar o mouse, o teclado e acessar o sistema de arquivos. O Windows Defender emite esse alerta para qualquer software que solicite essas permissões sem ter uma assinatura digital de grande publisher. O Roberty é seguro — essa é uma medida padrão do sistema operacional, não um indicativo de risco.

Arquivo bloqueado pelo Windows Explorer?

Se o Windows bloquear o arquivo antes mesmo de executá-lo: clique com o botão direito no instalador, selecione Propriedades, marque a opção Desbloquear na aba Geral e clique em OK. Depois execute normalmente.

Passo 2 — Fazer login​

  1. Insira seu e-mail e senha da conta Roberty.
  2. Selecione a workspace à qual este dispositivo pertencerá.

Se for a primeira vez usando o Roberty, crie sua conta em studio.roberty.app antes de continuar.

Passo 3 — Nomear o dispositivo​

Defina um nome para este dispositivo. Esse nome será exibido no Studio e nos logs de execução — escolha um nome que facilite a identificação no futuro.

Boas práticas
  • Use nomes descritivos e padronizados: SERVER-PROD-01, DESKTOP-DEV-JOAO, VM-FINANCEIRO
  • Prefira letras maiúsculas e hifens — evite espaços e caracteres especiais
  • Inclua o ambiente (DEV, HOMOLOG, PROD) para facilitar a gestão em workspaces com múltiplos dispositivos

Passo 4 — Configurações do serviço​

Nesta etapa você define as preferências técnicas do Runner. Na maioria dos casos, os valores padrão são adequados — só altere se houver um requisito específico do seu ambiente.

ConfiguraçãoDescriçãoPadrão
Banco de Dados LocalBanco utilizado para armazenar logs e a fila de execuçãoSQLite
Porta do Painel AdminPorta HTTP do painel de administração local — gerada automaticamente durante a instalaçãoGerada automaticamente
Senha do Painel AdminSenha para acessar o painel de administração local(definida por você)
Guarde a senha do painel admin

A senha do painel é definida apenas uma vez, nesta tela. Guarde-a em um local seguro — ela será necessária toda vez que você acessar o painel administrativo. Se precisar redefiní-la futuramente, entre em contato com o suporte.

Conflito de portas?

Se a porta gerada automaticamente já estiver em uso por outro serviço na máquina, você pode alterá-la aqui para uma porta disponível. Verifique antes com netstat -a no terminal.

Passo 5 — Finalizar​

Clique em Comece a usar. O Runner irá:

  1. Registrar o dispositivo na sua conta Roberty
  2. Iniciar os serviços em segundo plano
  3. Conectar automaticamente ao Roberty Studio

Em alguns segundos, o dispositivo aparecerá como Online no Studio.

Verificando a instalação​

Confirme que tudo está funcionando antes de vincular um robô:

No painel local:

  1. Abra o navegador na máquina instalada e acesse a URL exibida ao final da instalação (ex.: http://localhost:PORTA).
  2. Faça login com a senha definida na instalação.
  3. Verifique se o status do serviço exibe Ativo.

No Roberty Studio:

  1. Acesse studio.roberty.app.
  2. No menu lateral, vá até Dispositivos (ou acesse as configurações de qualquer robô → aba Dispositivos).
  3. O novo dispositivo deve aparecer com status Online.

Se o dispositivo não aparecer, consulte a seção de solução de problemas abaixo.

Solução de problemas​

O dispositivo não aparece como online no Studio

  • Confirme que a máquina tem acesso à internet sem proxy bloqueando as conexões de saída.
  • Verifique se há firewall ou antivírus bloqueando a porta configurada durante a instalação.

O painel de admin não abre no navegador

  • Confirme a porta correta: use a URL exibida ao final da instalação. Se não a anotou, verifique as configurações do Runner.
  • Em alguns ambientes corporativos, localhost pode estar bloqueado. Tente substituir localhost por 127.0.0.1 na URL.

Erro de autenticação ao fazer login no instalador

  • Confirme que o e-mail e senha estão corretos em studio.roberty.app.
  • Verifique se sua conta tem permissão para adicionar dispositivos à workspace.

O Windows bloqueia a execução mesmo após clicar em "Executar mesmo assim"

  • Clique com o botão direito no arquivo do instalador → Propriedades → aba Geral → marque Desbloquear → OK.
  • Se o problema persistir, tente desativar temporariamente o antivírus durante a instalação e reativá-lo após.

Próximos passos​