runix.config
A configuração obrigatória do seu projeto: um único arquivo para o site, a API e o bot manager.
Neste artigo
Onde colocar o arquivo
Crie um arquivo de texto chamado exatamente runix.config, sem extensão .txt, na raiz do projeto. Ele deve acompanhar os arquivos dentro de cada ZIP, tanto no primeiro envio quanto nas atualizações.
Se o ZIP tiver uma única pasta principal, coloque runix.config dentro dela, junto do código. Um arquivo discloud.config não substitui o runix.config.
meu-projeto.zip
├── runix.config
├── index.js
└── package.jsonExemplo: Node.js na versão latest
Use LANGUAGE=nodejs e VERSION=latest. latest é resolvido no servidor para a versão mais recente do catálogo RunixCloud no momento do envio. VERSION=LATEST e VERSION=Latest também são aceitos em todas as linguagens.
NAME=Meu projeto
MAIN=index.js
RAM=256
LANGUAGE=nodejs
VERSION=latestExemplo: Node.js 24
Para fixar a versão, altere somente VERSION. O valor precisa estar disponível para a linguagem escolhida.
NAME=Meu bot Node.js 24
MAIN=index.js
RAM=256
LANGUAGE=nodejs
VERSION=24Campos obrigatórios e opcionais
NAME: nome do projeto, com até 80 caracteres.
MAIN: caminho relativo do arquivo principal, como index.js, src/main.py, app.jar ou target/release/meu-app. Não use caminhos absolutos nem ../.
RAM: memória em MB, somente número inteiro, no mínimo 64. A reserva precisa caber no seu plano.
LANGUAGE: identificador da linguagem. Use os valores listados abaixo.
VERSION: latest ou uma versão aceita para a linguagem. Não use RUNTIME no lugar de LANGUAGE.
START (opcional): comando inicial. Quando omitido, o servidor determina o comando a partir de MAIN e do manifesto de dependências.
TYPE (opcional): bot ou site. A CPU continua compartilhada pelo plano. O disco não tem cota por projeto e não deve ser definido no runix.config.
Linguagens e versões disponíveis
LANGUAGE=nodejs → VERSION=latest, 26, 24, 22 ou 20. latest resolve atualmente para 26. O alias node também é aceito.
LANGUAGE=python → VERSION=latest, 3.15, 3.14, 3.13, 3.12 ou 3.11. latest resolve para 3.15.
LANGUAGE=go → VERSION=latest, 1.27, 1.26, 1.25, 1.24 ou 1.23. latest resolve para 1.27. O alias golang também é aceito.
LANGUAGE=java → VERSION=latest, 27, 25, 21 ou 17. latest resolve para 27.
LANGUAGE=php → VERSION=latest, 8.5, 8.4, 8.3 ou 8.2. latest resolve para 8.5.
LANGUAGE=ruby → VERSION=latest, 4.0, 3.4 ou 3.3. latest resolve para 4.0.
LANGUAGE=rust → VERSION=latest ou stable. Ambos usam o canal estável configurado na RunixCloud.
Exemplo: Python
NAME=Minha API Python
MAIN=main.py
RAM=256
LANGUAGE=python
VERSION=latestEnvio e confirmação
- 1
Inclua runix.config no ZIP.
- 2
No site, envie o ZIP e confira o resumo lido do arquivo; confirme para publicar.
- 3
No Discord, use .up ou .commit ID e continue no canal temporário indicado pelo bot. O canal contém instruções e um modelo de runix.config.
- 4
Confirme a publicação. Para alterar os dados, edite runix.config e envie o ZIP novamente.
Erros e atualizações
Sem runix.config ou com conteúdo inválido, o servidor recusa o ZIP antes de publicar. No site, o card de upload permanece acima do erro e há um botão para esta documentação.
Cada commit precisa incluir runix.config. LANGUAGE, VERSION, MAIN e START do novo arquivo passam a valer no deploy. Se RAM exceder a reserva atual, ajuste a memória do projeto antes de atualizar (no bot: .ram ID MB). O commit não amplia recursos silenciosamente.
BUILD e APT não são campos aceitos. Use os manifestos de dependências da linguagem e o fluxo de instalação do projeto.
