Fazer deploy de um app Actix

Última atualização em 28 de maio de 2026

Você pode encontrar o guia passo a passo para fazer deploy aqui.

Este guia mostra como fazer build e deploy de uma aplicação Actix na Hostman App Platform. Você verá como funciona o processo de build, como a plataforma seleciona o binário de execução e quais requisitos a aplicação precisa atender em runtime.

Build da Aplicação
Copiar link

A aplicação é compilada usando o seguinte ambiente:

  • Rust
  • Cargo

O processo de build é executado na raiz do repositório ou no diretório definido no campo Caminho do diretório do projeto.

O template utiliza um processo de build em múltiplos estágios. Na primeira etapa, o binário da aplicação é compilado em modo release. Na segunda etapa, a imagem final executa a aplicação compilada.

Por padrão, o seguinte comando é executado durante o build:

cargo build --locked --release

Certifique-se de que o projeto contém um arquivo Cargo.toml válido com todas as dependências configuradas corretamente.

A flag --locked faz com que o Cargo utilize as versões definidas no arquivo Cargo.lock. Garanta que o Cargo.lock esteja atualizado e versionado no repositório.

Se a aplicação precisar de pacotes adicionais do sistema durante o build, como bibliotecas OpenSSL, adicione-os no campo Dependências. Esses pacotes serão instalados antes da execução do comando cargo build.

Selecionando o Binário de Execução
Copiar link

Depois que o build é concluído, a App Platform seleciona o binário de execução usando a seguinte lógica:

  1. Se o comando de build incluir explicitamente a flag --bin <name> ou --bin=<name>, esse binário será utilizado.
  2. Se a flag --bin não for informada, o template tentará identificar o binário usando o valor default-run definido no Cargo.toml através do cargo metadata.
  3. Caso default-run não esteja configurado, o template fará uma varredura no diretório target/release.
  4. Se apenas um binário executável for encontrado, ele será utilizado automaticamente.
  5. Se houver múltiplos binários executáveis, o build será finalizado com erro. Nesse caso, informe explicitamente o binário no comando de build:
cargo build --locked --release --bin <name>

Requisitos da Aplicação
Copiar link

Certifique-se de que a aplicação esteja escutando em 0.0.0.0 e não em 127.0.0.1. Caso contrário, conexões externas não conseguirão acessar a aplicação.