Começar
Requisitos e dimensionamento
Sistema operacional, memória e disco, aceleradores, dependências e rede.
Nesta página
A Aptabit Platform roda em um servidor Linux da sua organização, físico ou virtual. Os valores abaixo vêm das verificações do próprio CLI. O dimensionamento de produção depende do número de pessoas, do volume de documentos e dos modelos locais escolhidos, e é definido por projeto com a Aptabit.
Sistema operacional
| Item | Requisito |
|---|---|
| Sistema | Linux em servidor ou máquina virtual. |
| Arquitetura | x86_64 ou arm64. Outras arquiteturas são bloqueadas pela verificação da máquina. |
| Distribuições | O CLI é um binário estático, sem dependência de glibc ou OpenSSL. Roda em qualquer Linux x86_64 ou arm64, incluindo RHEL 8, Ubuntu 20.04 e Debian 11. |
| Outros sistemas | macOS apenas para desenvolvimento. Windows não é suportado, e o WSL gera alerta. |
Memória e disco
| Recurso | Mínimo | Recomendado |
|---|---|---|
| Memória RAM | 4 GiB | 8 GiB |
| Disco livre | 10 GiB | 50 GiB |
Abaixo do mínimo, o aptabit check bloqueia a instalação. Sem modelos locais, a plataforma ocupa cerca de 4,6 GB em imagens e 0,7 GiB de RAM. Cada modelo local acrescenta a própria necessidade de memória (RAM ou memória de vídeo), e o aptabit check informa o maior modelo do catálogo que cabe na máquina.
Runtime de containers
- Docker Engine com Compose v2: caminho padrão do instalador guiado. O
docker-composev1 sozinho bloqueia a instalação. - Podman: suporte parcial, por configuração avançada.
- O usuário que executa o CLI precisa ter acesso ao Docker. A verificação também identifica Docker instalado via snap, modo rootless e SELinux.
Aceleradores
| Hardware | Como é usado |
|---|---|
| CPU | A plataforma funciona sem acelerador. O llama.cpp é o runtime padrão dos modelos locais; em processadores Intel, o OpenVINO também roda na CPU. |
| GPU NVIDIA | Por CUDA, com o driver NVIDIA e o NVIDIA Container Toolkit instalados. Sem o toolkit, a plataforma sobe na CPU e a verificação aponta o que falta. |
| GPU Intel | Integrada ou dedicada, por /dev/dri, nos runtimes OpenVINO e IPEX-LLM. |
| GPU AMD | Detectada pela verificação, mas ainda não usada: os modelos rodam na CPU. |
| NPU | Execução de modelos em NPU disponível. |
O aptabit check lista cada GPU e NPU da máquina, com memória, driver e acesso pelo Docker. Os runtimes vLLM, TensorRT-LLM e SGLang exigem GPU com CUDA. Veja Modelos, runtimes e aceleradores.
Dependências
Cada dependência pode rodar junto com a plataforma ou apontar para um serviço que a sua organização já opera:
| Dependência | Na stack | Externa |
|---|---|---|
| Banco relacional | PostgreSQL 16 | PostgreSQL gerenciado |
| Sessões e avisos da fila | Redis 7 | Redis gerenciado |
| Armazenamento de objetos | MinIO | Serviço compatível com S3 |
| Banco vetorial | Milvus 2.4 com etcd | Milvus ou Zilliz |
Veja Operação.
Rede
- Porta: o proxy da plataforma atende HTTP em uma porta (8080 por padrão).
- HTTPS: termine o TLS no balanceador ou no proxy reverso da sua organização.
- Instalação conectada: saída HTTPS para o Aptabit Manager, para o registry privado da Aptabit e para os registries públicos das imagens base (Docker Hub e quay.io), com o relógio a menos de um minuto do relógio do Aptabit Manager. Modelos locais gerenciados também baixam imagens de runtime e pesos do Hugging Face. Veja Outras conexões de saída.
- Instalação isolada: nenhuma saída para a Aptabit. Veja Licença e conectividade.
- Proxy corporativo: o CLI confia nas autoridades certificadoras do sistema. Um proxy que inspeciona HTTPS funciona depois que a CA dele entra no repositório de certificados do sistema.
Idiomas da interface
A interface web está disponível em nove idiomas, com português, inglês e espanhol como as traduções mais completas, e oferece temas claro e escuro. O CLI fala português do Brasil e inglês.
© 2026 NVIDIA, the NVIDIA logo, CUDA, and TensorRT are trademarks and/or registered trademarks of NVIDIA Corporation in the U.S. and other countries.
