Publique bots, sites e APIs pelo painel. Comece com uma aplicação gratuita ou use os recursos da sua VPS, acompanhando logs e configurações no mesmo lugar.
Uma aplicação grátis
Cada conta pode criar uma aplicação com 256 MB de RAM e 1 GB de disco, sujeita à disponibilidade de vagas. Clique em Criar aplicação grátis e envie um ZIP de até 100 MB ou selecione um repositório do GitHub vinculado.
O código Node.js ou Python roda em um container na VPS compartilhada das aplicações gratuitas, com limite de 0,25 vCPU e 128 processos. Os arquivos e as dependências instaladas contam no limite de disco. A instalação de dependências tem até 512 MB de RAM e 10 minutos; projetos que precisem de mais recursos devem usar uma VPS paga.
Sites e APIs recebem um subdomínio seu-projeto.cylinderweb.site. Todas as aplicações gratuitas compartilham o IP do servidor. Não há cobrança de plano ou IPv4, acesso SSH, banco de dados, domínio próprio ou backup automático nessa modalidade. Mantenha uma cópia do seu código. Logs, início, parada, reinício, variáveis de ambiente e atualizações ficam disponíveis no painel.
Contratar um plano não transfere a aplicação gratuita para sua VPS nem desconta seus 256 MB do plano. Os termos de uso aceitável também se aplicam às aplicações gratuitas.
Bots do Discord — contratação separada
Em Bots do Discord, escolha a memória de cada aplicação a partir de 100 MB por R$ 2,00 por mês. A contratação permite valores inteiros de 100 a 4.096 MB, conforme a memória disponível no momento. Para novas contratações, 256 MB custam R$ 3,90; 512 MB, R$ 5,90; 1.024 MB, R$ 9,90; 2.048 MB, R$ 18,90; e 4.096 MB, R$ 34,90. Para quantidades intermediárias, o painel calcula o valor entre as faixas e arredonda para cima a cada R$ 0,10. Assinaturas já contratadas e faturas existentes mantêm o preço registrado.
O valor exibido é o total do bot, sem cobrança de IPv4. Não precisa ter plano de VPS. A contratação, o vencimento e as faturas são independentes da VPS e da aplicação gratuita. A disponibilidade é compartilhada entre as assinaturas desse produto; ela não representa a RAM da sua VPS.
- Escolha um nome e a quantidade de RAM, confira o preço, gere a fatura e pague por Pix. Aguarde a confirmação automática.
- Envie um ZIP de até 100 MB com o código Node.js ou Python e seu
package.jsonourequirements.txt. Não inclua node_modules ou o ambiente virtual Python. - Informe o arquivo principal e, se necessário, o comando de inicialização. Também é possível definir
MAIN=index.jseSTART=npm startnocylinder.config. A memória aplicada será sempre a contratada, mesmo se o ZIP pedir outra quantidade. - Acompanhe a preparação pelo painel. Depois, use Iniciar, Parar, Reiniciar, Ver logs e Variáveis de ambiente. Salvar variáveis substitui a lista anterior e reinicia o bot.
Use Renovar para adicionar um mês à assinatura, mantendo a RAM e o preço contratado desse bot. A renovação preserva o período já pago e aparece em Faturas. Ao vencer, o bot é parado automaticamente; renovar permite ligá-lo novamente. Para mudar a memória de uma assinatura existente, entre em contato com o suporte ou contrate outra aplicação. Não há IP dedicado, SSH, domínio web ou banco de dados incluído nesse produto. Para sites, APIs e servidores próprios, use os planos de VPS. Mantenha uma cópia do projeto antes de atualizar ou excluir a aplicação.
01Seu primeiro deploy
- Com um plano ativo, aguarde sua VPS Linux ficar Pronta na aba Servidor.
- Clique em Nova aplicação, abaixo do workspace, e escolha ZIP ou GitHub.
- Confira os dados detectados, a memória disponível e se o projeto é um site/API ou um processo em segundo plano.
- Clique em Publicar aplicação. Acompanhe o envio, a instalação e o início pelo painel.
Abra a aplicação para iniciar, parar, reiniciar, ver logs e métricas de CPU, RAM e rede, editar variáveis e configurar domínios. Os projetos gerenciados executam em containers na VPS do seu workspace.
02Enviar um projeto ZIP
Arraste o arquivo ou clique em Enviar projeto .zip. O limite é 100 MB (104.857.600 bytes). O painel envia arquivos grandes em partes e mostra o progresso. A extração aceita até 12.000 entradas, 512 MB descompactados e 128 MB por arquivo. ZIPs criptografados, links simbólicos e caminhos que saiam do projeto são recusados.
Inclua o código e os arquivos de dependências, como package.json ou requirements.txt. Evite node_modules, .git, ambientes virtuais e credenciais. A plataforma instala as dependências no ambiente Node.js 22 ou Python 3.12. Se houver um script build no package.json, ele é executado durante a instalação.
Uma única pasta envolvendo o projeto é detectada automaticamente. Em monorepos, escolha o Diretório raiz; o arquivo de configuração deve estar nessa pasta. Para atualizar, abra a aplicação → Deploys → Enviar novo ZIP. A atualização preserva as configurações já salvas no painel.
03cylinder.config
Crie um arquivo de texto chamado cylinder.config na raiz do projeto. Use uma opção CHAVE=valor por linha; linhas vazias e comentários iniciados com # são permitidos. O arquivo é opcional e pode ter até 64 KB. Ao selecionar o ZIP ou o repositório/branch, as opções aparecem preenchidas para você revisar.
# Exemplo de bot Node.js
NAME=Meu bot
MAIN=index.js
RAM=256
TYPE=bot
AUTORESTART=true
# Exemplo de site ou API
NAME=Minha API
MAIN=src/server.js
RAM=512
TYPE=site
START=npm start
PORT=3000
SUBDOMAIN=minha-api
AUTORESTART=true
| Opção | Como funciona na CylinderHost |
|---|---|
NAME ou DISPLAY_NAME | Nome exibido no painel, até 60 caracteres. |
RAM ou MEMORY | Memória reservada em MB, inteiro entre 64 e 8192, limitada ao saldo da VPS. Padrão: 256. |
MAIN | Arquivo principal relativo à raiz: index.js, src/server.js ou main.py, por exemplo. Sem ele, a plataforma tenta detectar o início. |
TYPE | site para sites/APIs ou bot para processos sem endereço web. Também aceita WEB=true ou WEB=false. |
START | Comando de início de até 300 caracteres. Sem ele, usa o script start/preview do package.json ou executa o arquivo principal. |
PORT | Porta interna de 1 a 65535. Padrão: 3000. A aplicação web deve escutar em 0.0.0.0. |
SUBDOMAIN | Endereço gratuito nome.cylinderweb.site, com 3 a 40 letras minúsculas, números ou hífens. Sem TYPE/WEB, esta opção ativa o modo site. O nome precisa estar disponível. |
AUTORESTART | true ou false. Padrão: true. Usa a política de reinício do container; parar pelo painel mantém a aplicação parada. |
RUNTIME | nodejs ou python. Opcional; normalmente detectado pelo arquivo principal. |
VERSION | Aceita recommended: Node.js 22 ou Python 3.12. Outras versões e linguagens precisam de instalação manual por SSH. |
Prioridade: o que você altera no formulário prevalece sobre o arquivo; opções ausentes usam a detecção e os padrões da plataforma. Nos próximos deploys, as configurações salvas da aplicação são mantidas. Ajuste RAM, comando, variáveis e modo web nas abas da aplicação.
Para Python, use MAIN=main.py, RUNTIME=python e suas dependências em requirements.txt. Tokens e senhas ficam em Variáveis de ambiente, não no arquivo de configuração.
04Importar do GitHub
Clique em Importar do GitHub. Se a conta ainda não estiver vinculada ou precisar renovar a autorização, você será levado a Minha conta. Clique em Vincular/Reconectar GitHub, conclua a confirmação da conta e autorize. O retorno abre a seleção de projetos.
Em Autorizar repositórios, instale o GitHub App CylinderHost nos projetos desejados. A integração precisa de leitura de Contents e Metadata; instalações antigas podem solicitar a aprovação das novas permissões. Repositórios privados só aparecem com a autorização correspondente.
Busque o projeto, selecione a branch e, se necessário, a pasta raiz. O cylinder.config dessa pasta preenche o formulário. Clique em Publicar. Para buscar alterações futuras, use Deploys → Atualizar do GitHub; não há atualização automática a cada push.
Em um workspace compartilhado, o acesso aos repositórios usa o vínculo do dono. Se faltar autorização, o dono precisa fazer a vinculação.
05Sites, domínios e variáveis
Ative Aplicação web para receber um subdomínio HTTPS gratuito em cylinderweb.site. O programa precisa escutar em 0.0.0.0 e usar process.env.PORT (Node.js), os.environ["PORT"] (Python) ou a mesma porta interna informada no painel.
Em Network e domínios, adicione um domínio próprio e siga a instrução de DNS exibida para o IP da sua VPS. Use Verificar DNS e HTTPS após o apontamento.
Em Variáveis de ambiente, informe uma variável por linha: CHAVE=valor. São aceitas até 50 variáveis, com até 4.000 caracteres por valor. PORT e HOST são definidos pela plataforma para aplicações web. Ao salvar, a aplicação reinicia com os valores novos.
06Memória e limites
Aplicações gerenciadas e bancos compartilham a RAM do plano. Cada aplicação reserva o valor escolhido; o painel mostra o saldo restante e recusa valores acima dele. O container recebe esse limite de memória. Um arquivo de configuração não permite ultrapassar o saldo da VPS.
Escolha a RAM conforme seu projeto e acompanhe as métricas. Builds e instalação de dependências também precisam de recursos. Se o processo encerrar por falta de memória, confira os logs e ajuste a reserva dentro do seu plano.
Processos manuais com PM2
Também é possível instalar e executar projetos diretamente por SSH. Para Node.js: pm2 start bot.js --name meu-bot; para Python: pm2 start bot.py --name meu-bot --interpreter python3. Esses processos manuais são separados das aplicações criadas pelo assistente de deploy. Consulte-os com pm2 list e pm2 logs meu-bot.
05Bancos de dados
Em Banco de dados no painel você cria bancos gerenciados em container, cada um com usuário, senha e porta próprios na rede cylinder. Tipos disponíveis:
| Tipo | RAM mínima | String de conexão |
|---|---|---|
| MongoDB | 512 MB | mongodb://usuario:senha@host:porta/banco?authSource=admin |
| MySQL | 512 MB | mysql://usuario:senha@host:porta/banco |
| PostgreSQL | 256 MB | postgresql://usuario:senha@host:porta/banco |
| Redis | 64 MB | redis://:senha@host:porta/0 |
A RAM sai do saldo do plano; o disco usado conta no espaço do plano. A quantidade de bancos por plano aparece no card de cada plano em Planos. Senha e porta ficam disponíveis no painel a qualquer momento — nada é mostrado só uma vez aqui. Start/Reiniciar recriam o container (os dados ficam no volume, não se perdem).
06Blob Storage
Em Blob Storage você sobe arquivos (imagens, PDFs, uploads de usuários etc.) que ganham uma URL pública permanente em https://cylinderhost.com/blob/<id>/<nome>, em cache na Cloudflare por 1 hora. Cada arquivo pode ter até 50 MB; o total depende da cota de Blob Storage do seu plano (5 a 30 GB). Nomes repetidos não sobrescrevem: ganham um -2, -3… no final, então o link antigo continua funcionando.
07Backups automáticos
Todo banco de dados ganha backup automático diário, às 03:00 (horário de Brasília), guardando os 5 mais recentes de cada um (os mais antigos são descartados). Em Backups no painel você também pode gerar um backup manual na hora, baixar qualquer um, restaurar ou apagar. O espaço ocupado pelos backups conta no disco do plano, junto com os bancos de dados.
Backups da aplicação na sua VPS
Abra uma aplicação e escolha Backups para criar uma cópia manual do código no disco da própria VPS selecionada. Cada aplicação mantém até 5 cópias, com ZIP de até 100 MB. O espaço depende da cota e do disco livre do servidor; dependências como node_modules, ambientes Python e a pasta .git ficam fora do ZIP.
Você pode baixar, excluir ou restaurar uma cópia após confirmar a ação. Restaurar substitui o código e refaz o deploy, mantendo as configurações atuais da aplicação. Bancos de dados, volumes e arquivos de outras aplicações não entram nessa cópia. Backups antigos e os backups diários continuam separados e não são movidos por essa tela. A modalidade gratuita não inclui esse recurso.
A API usa GET/POST /api/apps/<id>/backups, GET /api/apps/<id>/backups/<arquivo>/download e POST /api/apps/<id>/backups/<arquivo>/restore ou /delete. Use o mesmo workspace e servidor da aplicação em todas as chamadas.
Logs e problemas comuns
Abra uma aplicação para acompanhar o console e as etapas do deploy. O botão Copiar permite compartilhar os logs com o suporte após remover informações privadas.
- Configuração inválida: confira a linha indicada, a RAM inteira e os valores true/false.
- Sem memória disponível: reduza a reserva ou libere recursos de outra aplicação/banco.
- Site sem resposta: confira a porta interna, o modo web e o endereço de escuta 0.0.0.0.
- Falha de início: veja dependências, comando, arquivo principal e variáveis exigidas pelo projeto.
- GitHub sem projetos: autorize os repositórios no GitHub App e atualize a lista.
- Upload interrompido: o painel tenta reenviar a parte com falha. Se não concluir, selecione o arquivo novamente. Envios incompletos expiram em 30 minutos.
09Servidor e SSH
A aba Servidor no painel mostra o uso de CPU/RAM/disco do seu servidor e tem os botões Iniciar, Reiniciar e Parar (o mesmo que POST /api/host/restart na Chave de API) — é aqui que você entra por SSH para instalar e rodar o que quiser (veja Aplicações com PM2).
Na VPS dedicada, a aba Servidor também gera uma chave SSH para entrar como root (mostrada uma única vez).
10Chave de API
Para ZIPs grandes através da Cloudflare, use o painel ou o protocolo em partes: POST /api/apps/uploads com JSON {"size":tamanhoEmBytes}; envie blocos de até chunkSize bytes em PUT /api/apps/uploads/<uploadId>?offset=0, avançando pelo offset retornado; finalize com POST /api/apps e JSON {"uploadId":"…"}. Para atualizar, envie esse JSON a /api/apps/<id>/redeploy. Autentique todas as chamadas; cada upload só pode ser consumido uma vez no mesmo workspace. Para cancelar, use DELETE na URL do upload.
Em Minha conta, gere uma chave de API para automatizar o painel fora do navegador: publicar aplicações, subir arquivos no Blob Storage, criar ou apagar bancos de dados, reiniciar seu servidor ou criar backups. A chave é mostrada uma única vez na hora em que é criada — guarde-a num cofre de segredos. Se perdê-la, gere outra (a antiga é invalidada) ou revogue quando não precisar mais.
Em toda chamada, envie a chave num destes cabeçalhos:
Authorization: Bearer ck_SuaChaveAqui
# ou
X-Api-Key: ck_SuaChaveAqui
A chave vale exatamente como estar logado: qualquer rota /api/* que o painel usa funciona também com ela, no lugar do cookie de sessão. As mais úteis para automação:
| Ação | Chamada |
|---|---|
| Status da conta e do plano | GET /api/me |
| Listar aplicações gerenciadas | GET /api/apps |
| Criar aplicação gerenciada com ZIP + cylinder.config | POST /api/apps — corpo application/zip |
| Atualizar código de uma aplicação | POST /api/apps/<id>/redeploy — corpo application/zip |
| Listar aplicações do PM2 | GET /api/host/pm2 |
| Enviar um ZIP pra rodar com PM2 | POST /api/host/pm2?name=&main=&ram= — corpo = bytes do .zip |
| Iniciar / parar / reiniciar aplicação do PM2 | POST /api/host/pm2/<nome>/start (também stop e restart) |
| Ver logs de uma aplicação do PM2 | GET /api/host/pm2/<nome>/logs?lines=300 |
| Reiniciar seu servidor | POST /api/host/restart (também start e stop) |
| Status/uso do servidor | GET /api/host/stats |
| Subir um arquivo no Blob Storage | POST /api/blob?name=arquivo.png (corpo = bytes do arquivo) |
| Listar arquivos do Blob Storage | GET /api/blob |
| Apagar um arquivo do Blob Storage | POST /api/blob/<nome>/delete |
| Criar um banco de dados | POST /api/dbs — JSON { type, name, ram, disk } |
| Apagar um banco de dados | POST /api/dbs/<id>/delete |
| Criar um backup na hora | POST /api/backups — JSON { id } |
Exemplo (gere uma chave em Minha conta e envie seu projeto com cylinder.config):
# gere a chave em Minha conta, depois:
curl -X POST "https://cylinderhost.com/api/apps" \
-H "Authorization: Bearer ck_SuaChaveAqui" \
-H "Content-Type: application/zip" \
--data-binary @meu-bot.zip
# criar um banco PostgreSQL de 256 MB e 1 GB de disco
curl -X POST https://cylinderhost.com/api/dbs \
-H "Authorization: Bearer ck_SuaChaveAqui" \
-H "Content-Type: application/json" \
-d '{"type":"postgres","name":"meubanco","ram":256,"disk":1}'
# reiniciar o servidor
curl -X POST https://cylinderhost.com/api/host/restart \
-H "Authorization: Bearer ck_SuaChaveAqui"11MCP para a IA
O MCP deixa uma IA (Cursor, Claude e outras) operar o painel com a mesma chave de API. Ela consulta a conta, liga e reinicia o servidor, lê logs, mexe nas aplicações PM2, cria bancos e backups. A chave continua em Minha conta e não fica gravada no código.
Na máquina da pessoa, com o arquivo mcp.js deste projeto:
{
"mcpServers": {
"cylinderhost": {
"command": "node",
"args": ["CAMINHO/mcp.js"],
"env": {
"CYLINDERHOST_API_KEY": "ck_SuaChaveAqui",
"CYLINDERHOST_URL": "https://cylinderhost.com"
}
}
}
}
Ferramentas: conta, servidor, servidor_uso, servidor_logs, servidor_energia, aplicacoes, aplicacao_logs, aplicacao_acao, aplicacao_zip, bancos, banco_criar, banco_acao, arquivos, arquivo_apagar, backups e backup_criar. A página MCP mostra a roda de IAs e o mesmo passo a passo.
OpenGL por CPU na VPS Linux
As VPS dedicadas Ubuntu e Debian recebem Mesa/llvmpipe e Xvfb automaticamente após ficarem prontas. A instalação é verificada e uma falha temporária é tentada novamente. Esse modo renderiza pela CPU, sem exigir uma GPU física ou um dispositivo /dev/dri/renderD128.
# Conferir o contexto OpenGL
cylinder-render --check
# Iniciar seu programa dentro de uma tela virtual
cylinder-render ./seu-programa argumento1Execute por SSH como o usuário do projeto. O wrapper usa uma sessão X temporária autenticada e não abre uma porta gráfica pública. As variáveis de renderização ficam restritas ao comando; os outros processos da VPS continuam com seu ambiente.
O processamento gráfico consome CPU e memória do seu plano. A compatibilidade depende das APIs, extensões e bibliotecas exigidas pelo programa. O teste confirma um contexto OpenGL llvmpipe, não o funcionamento de qualquer engine.
Pacotes instalados na VPS não são herdados por containers. Para um programa em Docker, instale Mesa e Xvfb dentro da imagem e execute com renderização por software dentro dela. Não use containers privilegiados para simular uma GPU.
Este recurso não altera o adaptador virtual e não oferece VirGL ou GPU dedicada. Se o programa exigir DRM, GPU, Vulkan ou outra API específica, verifique os requisitos e a disponibilidade com o suporte.
Referências: llvmpipe e variáveis do Mesa.
Ficou com dúvida? Fale com a gente em nosso servidor do Discord.