Pular para o conteúdo
DeskVoiceDeskVoiceGitHub ★ 32Instalar

Guia de instalação

Instalar o DeskVoice na sua VPS

Um servidor é um computador alugado que fica ligado o tempo todo; VPS é o nome usual desse aluguel. Este guia vai do “ainda não tenho servidor” até o painel aberto. Os comandos são os mesmos do repositório, letra por letra.

  1. Tenha um servidor

    Já tem uma VPS com Ubuntu 22.04 ou mais novo? Siga para o passo 2. Qualquer VPS com Docker funciona pelo mesmo comando, sem diferença de recurso.

    Se ainda não tem, a recomendada é a da parceira do projeto:

    Prefere um comando a uma página? No seu computador (macOS ou Linux), antes de ter servidor, este comando só informa: o que é preciso, o tamanho da máquina, o link da parceria e o comando seguinte. Não instala nem coleta nada.

    No seu computador
    curl -fsSL https://raw.githubusercontent.com/DeskLabs-OpenSource/DeskVoice/main/install/start.sh | bash

  2. Separe o que ter em mãos

    Uma VPS Ubuntu 22.04 ou mais nova
    A VPS da HostGator, parceira do projeto, é a recomendada. Qualquer VPS com Docker serve, pelo mesmo comando. Sobre memória, só o que foi medido: a instalação foi provada numa VPS de 8 GB e 4 vCPU, e o DeskVoice parado usa cerca de 400 MB. O menor tamanho em que a instalação cabe ainda não foi medido. As imagens publicadas são para processador x86_64 (amd64); em ARM a instalação constrói na própria máquina, com --build
    Um domínio apontado para a VPS
    Opcional para testar. Sem domínio não há HTTPS: o painel fica só dentro da VPS e você entra por túnel SSH (o instalador mostra o comando)
    Um tronco SIP com um número
    Contratado com a operadora de telefonia de sua escolha. Autenticação por registro ou por IP
    Uma chave de IA de voz
    Gemini (Google) ou OpenAI. Você paga o uso direto ao provedor

  3. Rode uma linha na VPS

    SSH é o jeito de abrir, do seu computador, um terminal dentro do servidor; a empresa da VPS informa o endereço e a senha. Docker é o programa que roda as partes do DeskVoice, e o instalador o instala se faltar. Entre na VPS por SSH e rode:

    Na VPS
    curl -fsSL https://raw.githubusercontent.com/DeskLabs-OpenSource/DeskVoice/main/install/get.sh | bash

    Ela baixa o DeskVoice em ~/DeskVoice e abre o instalador. Prefere ler antes de rodar? O mesmo resultado, passo a passo:

    Na VPS, passo a passo
    git clone https://github.com/DeskLabs-OpenSource/DeskVoice.git && cd DeskVoice && bash install/install.sh

    O instalador confere a máquina e a rede, pergunta o domínio, o nome da empresa, o seu nome, e-mail e senha, gera todos os segredos, sobe os serviços, cria o primeiro usuário e mostra o endereço do painel. Se faltar o Docker, ele pergunta e instala. Rodar de novo não quebra nada.

  4. Configure pela tela

    Daí em diante tudo se configura pelo painel: o tronco SIP, o número, a chave de IA e o agente. Nenhum recurso exige SSH para ser ligado.

    O passo a passo completo, do zero à primeira chamada, está em docs/guides/primeira-ligacao.md.

  5. Confira e mantenha

    A checagem de saúde mostra o estado de cada parte, uma linha por vez. Ela nunca resume tudo em um “ok”.

    Na VPS, dentro de ~/DeskVoice
    bash install/healthcheck.sh

    Para atualizar pelo terminal:

    Na VPS, dentro de ~/DeskVoice
    bash install/update.sh

    O que muda em cada versão, e o que pede atenção antes de atualizar, está nas notas de versão. O guia é docs/guides/atualizar.md.

Outros caminhos

Instalar com um assistente de IA

Usa Claude Code, Codex, Cursor ou outro assistente de código? Cole isto nele. A primeira pergunta dele é se você já tem um servidor. Senha e chave não vão para a conversa: entram pelo instalador ou pela tela.

Cole no assistente
Me ajude a instalar o DeskVoice: https://github.com/DeskLabs-OpenSource/DeskVoice
Leia o AGENTS.md do repositório e siga a skill deskvoice-instalar.

Ver uma chamada sem chave nem tronco

O repositório traz um motor de voz simulado. Ele roda uma chamada inteira, com saudação, ferramenta, pedido de aprovação, transferência e tarefa pós-chamada. Precisa de Docker: sobe um Postgres descartável e o remove ao sair.

No seu computador
git clone https://github.com/DeskLabs-OpenSource/DeskVoice.git && cd DeskVoice
pnpm install && pnpm demo

A instalação falhou ou a ligação ficou muda? Abra uma issue com o arquivo que bash install/diagnose.sh gera. Senhas, chaves e tokens saem ocultos nele.