A Nexcloud hospeda o seu código. Você envia um .zip ou conecta um repositório do GitHub, escolhe quanta memória o projeto precisa, e ele fica no ar com endereço, HTTPS e monitoramento — sem servidor para instalar, atualizar ou vigiar.

Junto com a aplicação você tem banco de dados gerenciado, armazenamento de arquivos servido por CDN e cópias para voltar atrás quando um deploy dá errado. Tudo pelo mesmo painel, na mesma conta, na mesma fatura.

Do que você não precisa cuidar

• Instalar sistema operacional, runtime ou dependência de sistema.
• Emitir e renovar certificado — o HTTPS vem pronto e se renova sozinho.
• Configurar processo para reiniciar quando cair: a plataforma religa sozinha.
• Montar painel de métricas: consumo, logs e histórico já vêm na tela.
• Escolher em que máquina o projeto roda, ou mudar alguma coisa quando ele muda de máquina.

1. 1No painel, abra Aplicações e clique em Nova aplicação.
2. 2Escolha a origem: envie um .zip com o projeto, ou conecte o GitHub e escolha o repositório e a branch.
3. 3Dê um nome e escolha a memória. Se não souber, comece pequeno — dá para aumentar depois sem recriar nada.
4. 4Marque se o projeto atende na web. Isso é o que decide se ele ganha um endereço público ou fica rodando sem porta exposta.
5. 5Confirme. A tela acompanha o deploy passo a passo; quando terminar, o endereço já responde.

Enviando um pacote

Você manda um .zip e pronto. É o caminho mais rápido para colocar algo no ar e o único que não exige conta em lugar nenhum. Para atualizar, envie um pacote novo.

Conectando o GitHub

Conecte a conta uma vez em Conexões e depois escolha, por aplicação, o repositório e a branch. Com o deploy automático ligado, cada push publica a versão nova — você não precisa criar webhook nem colar token no GitHub, a plataforma faz isso.

Dá para publicar a cada commit ou só quando você marca uma release. A segunda opção é a de quem quer decidir quando o cliente vê a mudança.

Republicar sem mudar o código

O botão de republicar refaz o deploy do que já está vinculado. Use quando o código é o mesmo mas o resultado precisa mudar: você trocou uma variável de ambiente, uma dependência publicou a correção, ou o deploy anterior falhou por algo passageiro.

A linguagem é reconhecida pelo projeto que você envia; não é preciso declarar nada. Estas são as versões em que a sua aplicação roda:

Se o seu projeto precisa de algo que não vem nessa lista — uma biblioteca de sistema, um binário externo —, inclua um Dockerfile no repositório e ele será usado no lugar da imagem padrão.

Quando algo não subiu, comece pelos deploys: é a tela que diz em que passo parou e por quê. Quando subiu mas não responde como devia, vá aos logs.

Uma snapshot é uma cópia da sua aplicação num instante. Você gera quando quiser — antes de uma mudança arriscada, por exemplo — e restaura com um clique se precisar voltar.

• Quantas você pode gerar por dia depende do plano: são duas por dia para cada 256 MB de memória contratada.
• Dá para baixar a cópia e guardar fora da plataforma.
• Apagar a aplicação apaga as snapshots dela junto. Se quiser guardar, baixe antes.

Todo website nasce com um endereço da plataforma e HTTPS já emitido — ele funciona no minuto seguinte ao deploy, sem você configurar DNS nenhum. Serve para testar, para mostrar para alguém e para deixar em produção se você não tiver domínio próprio.

1. 1Abra a aplicação, vá em Network e adicione o domínio (por exemplo, loja.seusite.com).
2. 2A tela mostra dois registros para você criar no seu provedor de DNS: um CNAME, que aponta o domínio para a plataforma, e um TXT, que prova que o domínio é seu.
3. 3Crie os dois exatamente como aparecem na tela e salve no seu provedor.
4. 4Volte ao painel e clique em verificar. Assim que os dois registros forem encontrados, o certificado é emitido e o domínio começa a responder.

A propagação de DNS costuma levar de alguns minutos a algumas horas, dependendo do seu provedor. Enquanto isso, o painel mostra em que etapa o domínio está.

• Confira se o CNAME aponta para o endereço que a tela mostra, e não para o IP de outro serviço. É a causa mais comum de um domínio que não sai de “pendente”.
• Confira se o TXT foi criado com o nome exato — alguns provedores acrescentam o seu domínio no fim do nome sozinhos, e o registro acaba duplicado.
• Se você usa proxy ou CDN de terceiro na frente, desligue-o durante a validação: ele intercepta a verificação.
• Depois de corrigir, clique em verificar de novo em vez de esperar — a reconsulta é imediata.

Escolha o engine, a versão e a memória. O banco é só seu — não é compartilhado com outros clientes — e a versão fica na que você escolheu: nada é atualizado por baixo do seu projeto.

A tela do banco mostra host, porta, usuário, senha e a URL de conexão pronta para copiar. Você conecta de qualquer lugar: da sua máquina, de um cliente gráfico, de um CI, ou de uma aplicação hospedada em outro provedor.

A conexão é cifrada. Para verificar o servidor de verdade em vez de aceitar qualquer certificado, baixe o ca.pem na própria tela do banco e aponte o seu cliente para ele.

Quantas conexões cabem

O limite de conexões simultâneas acompanha a memória contratada, e você pode ajustá-lo dentro de uma faixa que a tela mostra. Aumente com cuidado: conexões demais num banco pequeno trocam “conexão recusada” por um banco que cai — e aí derruba quem já estava conectado. Se a sua aplicação abre muitas conexões, prefira um pool no lado dela.

Vincular escreve a URL de conexão como variável de ambiente na sua aplicação e a reinicia. Você não precisa copiar senha para lugar nenhum — e quando a senha for rotacionada, a variável é atualizada sozinha.

O nome da variável vem com um padrão por engine (DATABASE_URL no PostgreSQL, por exemplo) e pode ser trocado na hora de vincular, se a sua aplicação espera outro nome.

O painel abre o conteúdo do banco sem você instalar cliente nenhum: lista as tabelas, pagina as linhas, busca por coluna e permite inserir, editar e apagar uma linha por vez. Há também um console para rodar comandos direto.

• A plataforma gera backups automáticos, e você pode desligá-los por banco.
• Você também pode gerar um agora, a qualquer momento — antes de uma migração, por exemplo.
• Cada backup tem prazo de validade, mostrado na lista. Para guardar por mais tempo, baixe o arquivo.

Apagar um banco apaga os dados. O disco fica guardado por alguns dias antes de ser destruído de vez, e a tela do banco mostra esse prazo — é a única rede de segurança que existe sobre essa operação, e ela não substitui um backup baixado.

Envie pelo painel e receba uma URL pública, servida por CDN e com cache longo. Use no src de uma imagem, no seu front-end, num e-mail — em qualquer lugar que aceite um endereço.

A URL de um arquivo nunca muda. Para trocar o conteúdo, envie o arquivo novo e atualize a referência: assim quem já tem a URL antiga continua vendo o que viu, e nada quebra sem aviso.

Executáveis e arquivos que um servidor poderia interpretar (.exe, .sh, .php e semelhantes) são recusados — é o que impede o CDN de virar hospedagem de malware. Renomear a extensão não contorna: o conteúdo do arquivo também é conferido. HTML e SVG podem ser enviados, mas são entregues como download em vez de abrir no navegador.

A memória é a medida principal, e ela é da conta inteira: aplicações e bancos dividem o mesmo total. Por isso um banco pode ser recusado porque as suas aplicações já ocuparam a memória — e vice-versa. A tela de criação sempre mostra quanto ainda cabe antes de você escolher o tamanho.

• Memória — a soma do que está reservado para todas as aplicações e bancos, ligados ou parados.
• Projetos — quantas aplicações você pode ter ao mesmo tempo.
• Bancos — quantos bancos o plano permite.
• Arquivos — o espaço total no CDN.

O plano gratuito serve para experimentar: cabe uma aplicação pequena, sem publicação na web e sem armazenamento de arquivos. O Empresarial é uma escada — você escolhe quantos GB quer, e projetos e arquivos acompanham.

Pagando por mais tempo, você paga menos

Um cartão-presente é um código que a Nexcloud gera e você resgata: ele ativa um plano por um número de dias, sem fatura, sem cartão e sem assinatura. Não é desconto e não é crédito — é tempo de plano.

1. 1Abra Planos no painel.
2. 2Digite o código no campo do topo. Pode colar com ou sem os hífens, em maiúscula ou minúscula.
3. 3Clique em resgatar. O plano entra na hora, e a data de término aparece ali mesmo.

As regras que costumam gerar dúvida

• Um resgate por conta. O mesmo código não vale duas vezes para você, mesmo quando ele foi feito para muita gente.
• Some ao que você já tem, se for o mesmo plano. Resgatar 30 dias com 20 dias restantes dá 50, e não 30 — o tempo que sobrava não se perde.
• Plano diferente é recusado. Um código de um plano não entra numa conta que está em outro. Ele continua válido para quando você estiver no plano certo.
• Se você já assina o mesmo plano, o presente empurra a sua próxima cobrança para a frente, em vez de criar um período à parte.
• O código pode ter prazo para ser usado, e ele é diferente da duração que o código dá. Um código pode dizer "resgate até 31 de dezembro" e ainda assim valer 30 dias a partir do dia em que você resgatar.

A cobrança é mensal e alinhada ao calendário: toda fatura cobre do dia 1 ao dia 1. Quem assina no meio do mês paga a primeira fatura proporcional, só dos dias até a virada.

• Pix — um QR code por fatura, pago quando você quiser.
• Pix Automático — você autoriza uma vez e a cobrança acontece sozinha a cada período.
• Cartão de crédito — guardado com segurança e cobrado a cada período.

Pagar o próximo período adiantado dá desconto, e ele é maior quanto mais cedo você paga. A tela de faturamento mostra quanto vale hoje.

Tudo que você faz no painel — publicar, reiniciar, criar banco, gerar snapshot, ler métricas — também dá para fazer por chamada HTTP. É o caminho para ligar a Nexcloud à sua esteira de CI, a um script de manutenção ou a um painel interno seu.

A lista completa de chamadas, com parâmetros e exemplos prontos para copiar, está na API Reference.

1. 1Abra Tokens de API e crie um token, marcando só o que aquela automação precisa fazer.
2. 2Copie o valor na hora: ele aparece uma única vez e não pode ser recuperado depois, nem pelo suporte.
3. 3Guarde num cofre de segredos — o das variáveis do seu CI, por exemplo. Nunca no código.

• Marque o mínimo. Um token que só publica não precisa poder ler a senha dos seus bancos.
• Um token por automação. Assim, revogar um não derruba os outros.
• Dê prazo de validade ao que é temporário: ele some sozinho se você esquecer dele.
• A lista mostra o último uso de cada token — é assim que você percebe um que vazou, e o botão de revogar corta o acesso na hora.

A página de status é pública e abre sem login — é onde olhar quando a suspeita é de que o problema não é seu. Ela mostra o estado atual, o histórico e os incidentes abertos.

Se o problema continuar, fale com o suporte pelo link no rodapé do painel. Ajuda muito mandar junto: o id da aplicação ou do banco, o horário aproximado e o que a tela de deploys ou de logs mostrou.