Skip to main content
O runtime Java roda arquivos JAR executáveis no JDK 25: bots, workers, APIs e sites. Você gera o JAR na sua máquina, e a Square Cloud o inicia com java -jar.

​
Antes de começar

  • Um Java Development Kit (JDK) na sua máquina. Se ainda não tiver um, você pode baixar o Eclipse Temurin no Adoptium.
  • Uma conta na Square Cloud: cadastre-se com seu e-mail ou GitHub.
  • Um plano ativo. Veja os planos e escolha o que combina com o seu projeto.

​
Configure a Square Cloud

Se você envia sua aplicação pelo dashboard, pode pular esta seção: o dashboard cria o arquivo de configuração squarecloud.app para você.

Referência do arquivo de configuração

O arquivo squarecloud.app diz à Square Cloud como executar a sua aplicação: o arquivo principal, a memória, a versão do runtime, o nome e, para um site, o subdomínio.
Aponte o MAIN para o seu JAR. Um arquivo de configuração completo para cada tipo de aplicação:
squarecloud.app
O MAIN aceita até 32 caracteres. Para um caminho mais longo, substitua-o por RUNTIME=java e START=java -jar <caminho-do-seu.jar>.

​
O que a Square Cloud executa

  • Se o campo START não estiver definido no arquivo de configuração, a Square Cloud executará java -jar MAIN, onde o arquivo especificado em MAIN é o arquivo JAR. Se o campo START estiver definido, o valor nele será executado diretamente. Para mais informações sobre os parâmetros do arquivo de configuração, visite parâmetros de configuração.

​
Porta e host para sites e APIs

A Square Cloud define a variável de ambiente PORT como 80. O seu servidor precisa escutar nessa porta e em todas as interfaces de rede (0.0.0.0). Com o Spring Boot, defina server.port=${PORT:80} no application.properties, como mostra o guia do Spring Boot.

​
Prepare o projeto

A Square Cloud não compila projetos Java: gere um JAR executável na sua máquina e envie-o.
  • Maven: execute mvn package; o JAR é gravado em target/. Para empacotar as suas dependências em um único JAR executável, use o plugin Maven Shade ou Assembly e configure-o para definir o Main-Class.
  • Gradle: execute ./gradlew build (ou gradle build); o JAR é gravado em build/libs/. Para empacotar as suas dependências, use o plugin Shadow (./gradlew shadowJar) ou defina o Main-Class no manifest da task jar.
Confira se o JAR inicia com java -jar sua-aplicacao.jar antes de enviá-lo. Compile-o para o Java 25 ou anterior: o runtime não consegue rodar classes compiladas para um Java mais novo.

​
Arquivos necessários

  • squarecloud.app, na raiz do ZIP.
  • O seu JAR executável, definido em MAIN. O META-INF/MANIFEST.MF fica dentro do JAR, e não como um arquivo separado, e precisa declarar o Main-Class da sua aplicação.
O arquivo de configuração (squarecloud.app) deve estar localizado na raiz do arquivo zip. Caso contrário, a Square Cloud não conseguirá encontrá-lo durante o deploy.

​
O que deixar de fora

  • O código-fonte e as pastas de build são opcionais: o JAR já contém a aplicação compilada.

​
Guias de frameworks

Spring Boot

​
Solução de problemas

O JAR não tem Main-Class no manifest, então o java -jar não consegue iniciá-lo. Gere um JAR executável como descrito em Prepare o projeto.
O JAR foi compilado para um Java mais novo que o JDK 25. Compile-o para o Java 25 ou anterior.
Para outros problemas, veja Solução de problemas.

​
Faça o deploy

​
Via dashboard

1

Acesse a página de upload

Acesse a página de upload e envie seu arquivo zip.
2

Configure seu ambiente

Após fazer o upload do seu arquivo zip, você precisará configurar o nome, o arquivo principal ou o ambiente de execução e outras configurações do seu projeto.
Se você estiver enviando um projeto web, certifique-se de selecionar “Publicação na Web” e definir um subdomínio para o seu projeto.
3

Faça o deploy do projeto

Por fim, clique no botão “Deploy” para hospedar seu projeto na Square Cloud. Após o deploy, você poderá monitorar o status e os registros do seu projeto no dashboard.
Enviando aplicação para a Square Cloud
4

Confirme que seu app está no ar

Seu primeiro deploy geralmente leva menos de um minuto. No dashboard, aguarde o status da sua aplicação mudar para em execução e verifique os registros em busca de erros de inicialização.
Se você fez deploy de um site ou API, abra https://<seu-subdominio>.squareweb.app no navegador: você deve ver sua aplicação respondendo. Se você fez deploy de um bot, envie um comando para confirmar que ele está online.
Seu app não está iniciando? Veja o guia de solução de problemas para as causas e correções mais comuns.

​
Via CLI

Para usar esse método, seu projeto precisa de um arquivo de configuração chamado squarecloud.app na raiz. Ele informa à Square Cloud como executar a sua aplicação.

Guia do arquivo de configuração

Saiba como criar o arquivo de configuração squarecloud.app que define o ambiente da sua aplicação.
1

Instale a CLI

Instale a CLI da Square Cloud. Se você já a tem, execute o mesmo comando para atualizá-la:
2

Faça login

Execute o comando abaixo. Ele abre o seu navegador: aprove o login lá e a CLI está pronta. Não há nenhuma chave de API para copiar. Para scripts e CI, veja autenticação da CLI.
3

Envie o seu projeto

Na pasta do seu projeto, execute o comando abaixo. A CLI compacta a pasta atual, deixando de fora o que o squarecloud.ignore lista, e faz o upload:
Para enviar um zip que você mesmo criou, passe-o com --file:
4

Confirme que seu app está no ar

Seu primeiro deploy geralmente leva menos de um minuto. Verifique o status e os registros da sua aplicação diretamente pelo terminal:
Se você fez deploy de um site ou API, abra https://<seu-subdominio>.squareweb.app no navegador: você deve ver sua aplicação respondendo. Se você fez deploy de um bot, envie um comando para confirmar que ele está online.
Seu app não está iniciando? Veja o guia de solução de problemas para as causas e correções mais comuns.

​
Próximos passos

Variáveis de ambiente

Mantenha segredos e configurações fora do código e leia-os em tempo de execução.

Domínio personalizado

Sirva a sua aplicação no seu próprio domínio, a partir do plano Standard.

Solução de problemas

Corrija uma aplicação que não inicia ou um site que não responde.

​
Contate-nos

Se você continuar enfrentando dificuldades técnicas, nossa equipe de suporte especializada está disponível para auxiliá-lo. Entre em contato conosco e teremos prazer em ajudá-lo a resolver qualquer questão: a qualidade do suporte é uma grande parte do motivo pelo qual desenvolvedores avaliam a Square Cloud com 4,9/5 em 402 avaliações no Google e Trustpilot.