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-compose v1 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.

Documentaçãov3.7