Voltar para Aprenda

Aptabit Platformv3.7

Começar

Instalação rápida

Da chave de instalação ao primeiro acesso, em um servidor Linux.

Nesta página

Este guia instala a Aptabit Platform em um único servidor Linux com Docker, da chave de instalação ao primeiro acesso. Para uma máquina sem acesso ao Aptabit Manager, veja Instalação isolada. Para bancos e armazenamento externos, veja Operação.

Antes de começar

  • Servidor Linux x86_64 ou arm64 com pelo menos 4 GiB de RAM e 10 GiB de disco livre (recomendado: 8 GiB e 50 GiB). Veja Requisitos e dimensionamento.
  • Docker Engine com Compose v2, utilizável pelo seu usuário.
  • O comando de instalação da sua licença, exibido no Aptabit Manager, com a chave de instalação (aptk_...). A chave pode ser reutilizada até o limite de instalações da licença.

Verifique o Docker:

Shell
docker --version
docker compose version
docker ps

Se docker ps falhar por permissão, corrija o acesso ao Docker antes de continuar. O CLI não precisa de root, mas depende desse acesso.

1. Instale o CLI

Execute o comando exibido no Aptabit Manager. Ele tem esta forma:

Shell
curl -fsSL 'https://manager.aptabit.com/v1/installations/install.sh' \
  | env APTABIT_MANAGER_URL='https://manager.aptabit.com' APTABIT_INSTALL_KEY='<chave-de-instalacao>' sh

O script baixa o CLI para o sistema e a arquitetura da máquina, confere o arquivo com o manifesto de versão assinado pela Aptabit e guarda as configurações do Aptabit Manager em ~/.aptabit/bootstrap.env. Em um terminal, ele oferece executar aptabit install em seguida.

Confirme a versão:

Shell
aptabit --version

O CLI fala português do Brasil e inglês. Ele pergunta o idioma na primeira execução; --lang pt-BR ou --lang en altera a escolha.

2. Verifique a máquina

Shell
aptabit check

O relatório cobre sistema operacional, memória e disco, Docker e Compose, GPUs e NPUs, alcance do Aptabit Manager, confiança no certificado, relógio e proxy. Um item bloqueante interrompe a instalação antes que qualquer arquivo seja gravado (código de saída 3). O aptabit install executa essa verificação automaticamente.

3. Instale a plataforma

Shell
aptabit install

O instalador pergunta o local da instalação, a porta HTTP e o nome da organização, com padrões para um servidor único. Em uma máquina nova, ele:

  1. Cria a identidade da instalação: um par de chaves Ed25519 gerado na própria máquina.
  2. Registra o servidor no Aptabit Manager com a chave de instalação. Quando a licença exige aprovação, aguarda a aprovação da Aptabit por até 20 minutos; executar aptabit install de novo retoma de onde parou.
  3. Gera os arquivos da instalação e inicia a stack.

O install é seguro de repetir. Com uma instalação existente, ele atualiza no lugar e preserva os dados. Remover uma instalação exige o comando avançado aptabit uninstall, que pede a digitação do caminho da instalação para confirmar.

Cada instalação fica em uma pasta própria:

Texto
<instalacao>/
  config.yaml          # fonte de verdade da instalação
  docker-compose.yml   # gerado a partir do config.yaml
  identity/            # identidade da instalação (chave privada local)

4. Conclua o primeiro acesso

Ao terminar, o aptabit install indica o endereço da página /setup. Nela, crie a organização e a conta do proprietário. Com chave de instalação, não há token a informar: a licença já está vinculada à instalação.

O mesmo pode ser feito pelo terminal, com as mesmas verificações da página:

Shell
aptabit setup

Para automação, sem perguntas:

Shell
aptabit setup \
  --config /opt/aptabit/producao/config.yaml \
  --tenant-name "Minha Organização" \
  --email owner@example.com \
  --display-name "Owner" \
  --password-stdin < senha-owner.txt

Informe a senha por --password-stdin ou pela variável APTABIT_SETUP_PASSWORD. Uma senha na linha de comando fica no histórico do shell e na lista de processos. A senha precisa ter pelo menos 12 caracteres.

A conta criada no setup é a conta root: entra sempre com e-mail e senha, nunca participa do SSO e é o caminho de volta caso o provedor de identidade falhe. Veja Usuários, papéis e acesso.

Para saber se o setup ainda está pendente:

Shell
curl http://localhost:8080/api/v1/setup

5. Verifique e acesse

Shell
aptabit status
aptabit license

Abra http://<servidor>:8080 no navegador e entre com a conta do proprietário. O proxy da plataforma atende HTTP; para HTTPS, publique a plataforma atrás do balanceador ou do proxy reverso da sua organização.

Próximos passos

  1. Em Configurações > Modelos, conecte um provedor externo ou implante um modelo local e habilite-o em um workspace. Veja Modelos, runtimes e aceleradores.
  2. Em Armazenamento, crie um contexto de conhecimento e envie os primeiros documentos. Veja Armazenamento.
  3. Em Configurações > Usuários e acesso, cadastre as pessoas, conceda os módulos e, se desejar, configure o SSO.
  4. Em Fluxos, comece por um dos 30 templates de fluxo. Veja Fluxos e agendamentos.

Documentaçãov3.7