Introduction
To develop and host on Square Cloud, it’s essential to follow a structured sequence of configurations and prerequisites. This technical guide will cover the entire process, from initial setup to production deployment.Prerequisites
- Square Cloud Account: Hosting platform for your application. Register through the signup page using your email.
- Active Paid Plan: Ensures dedicated resources and optimized performance for your application. Check our available plans and choose the most suitable for your needs.
Está se perguntando quanta RAM e CPU seu plano precisa para hospedar aplicações Express?
Não se preocupe, estamos aqui para ajudar. Nosso plano Standard oferece 4GB de RAM e 4vCPU, o que deve ser suficiente para a maioria dos aplicações Express. No entanto, se você estiver trabalhando em um projeto maior e precisar de mais estabilidade, recomendamos considerar nosso plano Pro. Com recursos adicionais, você pode manter a estabilidade mesmo durante picos de demanda. Para comprar, basta clicar aqui.
Não se preocupe, estamos aqui para ajudar. Nosso plano Standard oferece 4GB de RAM e 4vCPU, o que deve ser suficiente para a maioria dos aplicações Express. No entanto, se você estiver trabalhando em um projeto maior e precisar de mais estabilidade, recomendamos considerar nosso plano Pro. Com recursos adicionais, você pode manter a estabilidade mesmo durante picos de demanda. Para comprar, basta clicar aqui.
Criando o projeto
Para criar uma aplicação Express, você precisa ter Node.js e npm instalados no seu sistema antes de seguir os passos.Instalando a biblioteca
Para usar Express, você precisa instalá-lo no seu sistema. Execute o seguinte comando:express no seu sistema, permitindo que você o utilize em sua aplicação.
Desenvolvendo o projeto
Para criar um novo projeto Express, você pode começar criando um novo arquivo e escrevendo o seguinte código:app.js
Deploying
Depois de preparar os arquivos do seu projeto, você pode enviá-lo para a Square Cloud e hospedar sua aplicação. Para isso, crie um arquivo ZIP contendo todos os arquivos do seu projeto.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.
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
Finally, click on the "Deploy" button to host your project on Square Cloud.
After deployment, you can monitor your project's status and logs from the dashboard.
After deployment, you can monitor your project's status and logs from the dashboard.

Via CLI
Para usar esse método, você precisa criar um arquivo de configuração chamadosquarecloud.app no diretório raiz do seu projeto. Esse arquivo conterá a configuração necessária para o seu projeto.
Saiba mais sobre: Como criar arquivo de configuração da Square Cloud.
O arquivo squarecloud.app é um arquivo de configuração que será usado para configurar seu aplicativo; ele será usado para definir seu ambiente.
1
Primeiro Passo
Primeiro, você precisa ter a CLI instalada em seu ambiente. Se você ainda não a possui, execute o seguinte comando em seu terminal:Se você já a possui, recomendamos atualizá-la. Para fazer isso, execute o seguinte comando em seu terminal:
- Windows
- Linux, macOS, e WSL
2
Segundo Passo
Agora, para autenticar e usar outros comandos da CLI, você encontrará sua chave de autorização aqui clicando em "Solicitar Chave da API". Após obter sua chave de autorização, execute o seguinte comando:
3
Terceiro Passo
Finalmente, para fazer o deploy da sua aplicação para a Square Cloud usando a CLI, você precisa executar o seguinte comando:Ou se já possui o zip criado:
Recursos Adicionais
Para mais informações sobre Express e suas ferramentas, visite a documentação oficial do Express. Lá você encontrará guias detalhados, tutoriais e documentação de API para ajudá-lo a aproveitar ao máximo o Express.Solução de Problemas
Domínio Personalizado
Para usar domínio personalizado (ex:
meusite.com) ao invés da URL padrão https://meusite.squareweb.app/, você precisa do plano Standard ou superior. O subdomínio é definido pelo campo SUBDOMAIN no arquivo de configuração. Veja: Como configurar seu domínio personalizado.Requisitos Mínimos de RAM
Mínimo: 512MB de RAM para websites/APIs simples. Para sites com frameworks (Next.JS, React, Vue, Angular, etc.), sugerimos sempre pelo menos 1GB de RAM. Para aplicações maiores, use mais RAM para evitar erro LACK_OF_RAM e garantir performance.
Não foi possível encontrar esse site.
Verifique se o subdomínio/domínio corresponde ao configurado no campo SUBDOMAIN ou nas configurações de domínio personalizado. Se você acabou de enviar o site, aguarde até 60 segundos para a Square liberar o primeiro acesso.

Site demorou demais para responder...
Verifique se configurou corretamente a porta 80 e host 0.0.0.0 na aplicação. Recomendamos usar as variáveis de ambiente forçadas da Square: PORT e HOST do arquivo 
.env.

