Fazer deploy de um app Ktor

Ú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 Ktor na Hostman App Platform. Você verá como funciona o ambiente de build, como a plataforma escolhe o arquivo JAR para 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:

  • OpenJDK
  • Kotlin
  • Gradle

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

Se o projeto incluir um arquivo gradlew, o template utilizará o Gradle Wrapper durante o build. Caso contrário, será utilizada a instalação padrão do Gradle disponível no sistema.

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

./gradlew buildFatJar --no-daemon

Se o Gradle Wrapper não estiver disponível, o seguinte comando será utilizado:

gradle buildFatJar --no-daemon

Selecionando o Arquivo JAR de Execução
Copiar link

Depois que o build é concluído, a App Platform seleciona o arquivo JAR usando a seguinte lógica:

  1. Se o diretório build/libs/ contiver um arquivo compatível com o padrão *-all.jar, esse arquivo será utilizado. Normalmente, esse é o fat JAR gerado pelo Ktor.
  2. Se nenhum arquivo *-all.jar for encontrado, a plataforma utilizará o primeiro arquivo .jar encontrado dentro de build/libs/.

Certifique-se de que o plugin Gradle do Ktor esteja configurado corretamente e que a task buildFatJar esteja disponível no projeto.

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.