Instalação · 6 min read · Dec 21, 2025

Como Instalar o Helpy Customer Helpdesk no Ubuntu 20.04

Helpy é um aplicativo de suporte ao cliente gratuito, de código aberto e moderno que proporciona uma experiência heroica aos seus clientes. Ele é escrito em Ruby on Rails e pode ser facilmente integrado ao seu aplicativo e e-mail de entrada via Sendgrid, Mandrill, Mailgun, etc. Por padrão, o Helpy funciona em todos os dispositivos imediatamente, para que você possa encantar os clientes com respostas rápidas, de qualquer lugar e a qualquer momento! Ele possui uma opção de pesquisa avançada que ajuda você a filtrar e encontrar tickets ou clientes quando você tem milhares.

Neste post, mostraremos como instalar o Helpy Helpdesk no Ubuntu 20.04.

Pré-requisitos

  • Um servidor rodando Ubuntu 20.04.
  • Uma senha de root configurada no servidor.

Começando

Antes de começar, é recomendado atualizar todos os pacotes do sistema para a versão mais recente. Você pode fazer isso executando o seguinte comando:

apt-get update -y

Uma vez que os pacotes do seu sistema estejam atualizados, instale outras dependências necessárias usando o seguinte comando:

apt-get install apt-transport-https ca-certificates curl software-properties-common

Após instalar todos os pacotes, você pode prosseguir para a próxima etapa.

Instalar Docker CE e Docker Compose

Vamos instalar o Helpy no contêiner Docker. Portanto, o Docker e o Docker Compose devem ser instalados no seu servidor. Primeiro, adicione o repositório do Docker CE usando o seguinte comando:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | apt-key add -  
add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

Em seguida, atualize o banco de dados do repositório e instale o Docker CE com o seguinte comando:

apt-get update -y  
apt-get install docker-ce docker-ce-cli containerd.io -y

Uma vez que o Docker CE esteja instalado, inicie e habilite o serviço Docker CE usando o seguinte comando:

systemctl start docker   
systemctl enable docker

Em seguida, verifique o status do Docker CE com o seguinte comando:

systemctl status docker

Você receberá a seguinte saída:

? docker.service - Docker Application Container Engine
     Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
     Active: active (running) since Mon 2022-02-28 02:01:20 UTC; 1min 14s ago
TriggeredBy: ? docker.socket
       Docs: https://docs.docker.com
   Main PID: 3092 (dockerd)
      Tasks: 7
     Memory: 28.2M
     CGroup: /system.slice/docker.service
             ??3092 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.107814282Z" level=warning msg="Seu kernel não suporta CPU realtime >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.107957338Z" level=warning msg="Seu kernel não suporta cgroup blkio >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.108078251Z" level=warning msg="Seu kernel não suporta cgroup blkio >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.108501788Z" level=info msg="Carregando contêineres: iniciar."
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.257733781Z" level=info msg="A ponte padrão (docker0) foi atribuída com um >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.354919857Z" level=info msg="Carregando contêineres: concluído."
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.382579537Z" level=info msg="O daemon do Docker" commit=459d0df graphdriver(s)=>
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.383119787Z" level=info msg="O daemon completou a inicialização"
Feb 28 02:01:20 ubuntu2004 systemd[1]: Started Docker Application Container Engine.
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.444535011Z" level=info msg="API escutando em /run/docker.sock"

Em seguida, baixe a versão mais recente do Docker Compose usando o seguinte comando:

curl -s https://api.github.com/repos/docker/compose/releases/latest | grep browser_download_url | grep docker-compose-linux-x86_64 | cut -d '"' -f 4 | wget -qi -

Em seguida, defina a permissão de execução para o binário do Docker Compose com o seguinte comando:

chmod +x docker-compose-linux-x86_64

Em seguida, mova o binário do Docker Compose para o caminho do sistema com o seguinte comando:

mv docker-compose-linux-x86_64 /usr/local/bin/docker-compose

Em seguida, verifique a versão do Docker Compose com o seguinte comando:

docker-compose version

Você receberá a seguinte saída:

Docker Compose version v2.2.3

Instalar Helpy

Em seguida, baixe a versão mais recente do Helpy com o seguinte comando:

git clone https://github.com/helpyio/helpy.git

Uma vez que o download esteja concluído, mude o diretório para helpy e renomeie o arquivo de ambiente:

cd helpy  
cp docker/.env.sample docker/.env

Em seguida, edite o Caddyfile e defina o endereço IP do seu servidor:

nano docker/Caddyfile

Defina o IP do seu servidor como mostrado abaixo:

your-server-ip:80 {
  tls off
  root /helpy/public

  header /assets {
    gzip
    Expires "Thu, 31 Dec 2037 23:55:55 GMT"
    Cache-Control public
  }

  header /uploads

  proxy / helpy:8080/ {
    except /assets
    except /uploads
    header_upstream Host {host}
    header_upstream X-Real-IP {remote}
    header_upstream X-Forwarded-Proto {scheme}
  }
  log stdout
}

Salve e feche o arquivo, então construa o contêiner Helpy com o seguinte comando:

docker-compose build

Você deve ver a seguinte saída:

 ---> Running in a3a5fe591ac2
Removing intermediate container a3a5fe591ac2
 ---> 7babb0f60867
Step 13/20 : VOLUME $HELPY_HOME/public
 ---> Running in bfc08d37a2e1
Removing intermediate container bfc08d37a2e1
 ---> b4a06ac5bd7b
Step 14/20 : USER root
 ---> Running in a2e81c390825
Removing intermediate container a2e81c390825
 ---> d4275c0cd8aa
Step 15/20 : COPY . $HELPY_HOME/
 ---> 03684c78036c
Step 16/20 : RUN chown -R $HELPY_USER $HELPY_HOME
 ---> Running in 5b8d7b23cab6
Removing intermediate container 5b8d7b23cab6
 ---> 8406e643b688
Step 17/20 : USER $HELPY_USER
 ---> Running in bf9c512f2486
Removing intermediate container bf9c512f2486
 ---> abccf6d62cdf
Step 18/20 : COPY docker/database.yml $HELPY_HOME/config/database.yml
 ---> fbff2ecf5a58
Step 19/20 : EXPOSE 3000
 ---> Running in db600cd62ecc
Removing intermediate container db600cd62ecc
 ---> 8ed9fd111cd4
Step 20/20 : CMD ["/bin/bash", "/helpy/docker/run.sh"]
 ---> Running in 4c48d0132cd3
Removing intermediate container 4c48d0132cd3
 ---> ac095ecbbac6
Successfully built ac095ecbbac6
Successfully tagged helpy_helpy:latest

Use 'docker scan' to run Snyk tests against images to find vulnerabilities and learn how to fix them

Em seguida, inicie o contêiner Helpy com o seguinte comando:

docker-compose up -d

Você deve ver a seguinte saída:

[+] Running 19/19
 ? postgres Pulled                                                                                                                      16.6s
   ? 619014d83c02 Pull complete                                                                                                          8.0s
   ? 7ec0fe6664f6 Pull complete                                                                                                          8.7s
   ? 9ca7ba8f7764 Pull complete                                                                                                          8.9s
   ? 9e1155d037e2 Pull complete                                                                                                          9.2s
   ? febcfb7f8870 Pull complete                                                                                                         10.4s
   ? 8c78c79412b5 Pull complete                                                                                                         10.5s
   ? 5a35744405c5 Pull complete                                                                                                         10.6s
   ? 27717922e067 Pull complete                                                                                                         10.6s
   ? 36f0c5255550 Pull complete                                                                                                         15.2s
   ? dbf0a396f422 Pull complete                                                                                                         15.3s
   ? ec4c06ea33e5 Pull complete                                                                                                         15.4s
   ? e8dd33eba6d1 Pull complete                                                                                                         15.5s
   ? 51c81b3b2c20 Pull complete                                                                                                         15.6s
   ? 2a03dd76f5d7 Pull complete                                                                                                         15.7s
 ? frontend Pulled                                                                                                                      11.3s
   ? 743f2d6c1f65 Pull complete                                                                                                          7.8s
   ? 6bfc4ec4420a Pull complete                                                                                                         10.2s
   ? 688a776db95f Pull complete                                                                                                          10.4s
[+] Running 6/6
 ? Network helpy_front          Created                                                                                                  0.1s
 ? Network helpy_back           Created                                                                                                  0.1s
 ? Volume "helpy_rails-assets"  Created                                                                                                  0.0s
 ? Container helpy-postgres-1   Started                                                                                                  1.4s
 ? Container nginx              Started                                                                                                  1.5s
 ? Container helpy-helpy-1      Started                                                                                                  3.3s

Em seguida, verifique todos os contêineres em execução usando o seguinte comando:

docker ps

Você deve ver a seguinte saída:

CONTAINER ID   IMAGE          COMMAND                  CREATED         STATUS         PORTS                                                                      NAMES
8168c6d11c75   helpy_helpy    "/bin/bash /helpy/do…"   2 minutes ago   Up 2 minutes   0.0.0.0:3000->3000/tcp, :::3000->3000/tcp                                  helpy-helpy-1
265597cbcbea   postgres:9.4   "docker-entrypoint.s…"   2 minutes ago   Up 2 minutes   5432/tcp                                                                   helpy-postgres-1
b671e0a7ba1e   nginx:1.15     "nginx -g 'daemon of…"   2 minutes ago   Up 2 minutes   0.0.0.0:80->80/tcp, :::80->80/tcp, 0.0.0.0:443->443/tcp, :::443->443/tcp   nginx

Acessar a Interface Web do Helpy

Agora, abra seu navegador e acesse a interface web do Helpy usando a URL http://your-server-ip. Você deve ver a seguinte tela:

Clique em Vamos configurar seu Helpy. Você deve ver a tela de criação da conta de administrador:

Forneça seu nome de usuário, senha, endereço de e-mail e clique no botão Salvar Alterações. Você deve ver a tela Personalizar seu helpdesk:

Personalize seu Helpdesk conforme sua necessidade, caso contrário, clique no botão Pular por agora. Você deve ver a tela de configuração do servidor SMTP:

Forneça as informações do seu servidor SMTP ou clique no botão Pular por agora. Você deve ver a seguinte tela:

Clique no botão Começar!. Você deve ver o painel do Helpy na tela seguinte:

Conclusão

Parabéns! você instalou com sucesso o sistema Helpy Customer Helpdesk no Ubuntu 20.04. Agora você pode implantar o Helpy em sua organização e começar a gerenciar seus clientes. Sinta-se à vontade para me perguntar se você tiver alguma dúvida.

Share: X/Twitter LinkedIn
#Instalação

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.