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: 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
Acesse a página de upload
Acesse a página de upload e envie seu arquivo zip.
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.
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.
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
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:
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 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.


