Volver a Aprenda

Aptabit Platformv3.7

Primeros pasos

Instalación rápida

De la clave de instalación al primer acceso, en un servidor Linux.

En esta página

Esta guía instala la Aptabit Platform en un único servidor Linux con Docker, desde la clave de instalación hasta el primer acceso. Para una máquina sin acceso a Aptabit Manager, consulte Instalación aislada. Para bases de datos y almacenamiento externos, consulte Operación.

Antes de comenzar

  • Servidor Linux x86_64 o arm64 con al menos 4 GiB de RAM y 10 GiB de disco libre (recomendado: 8 GiB y 50 GiB). Consulte Requisitos y dimensionamiento.
  • Docker Engine con Compose v2, utilizable por su usuario.
  • El comando de instalación de su licencia, que se muestra en Aptabit Manager, con la clave de instalación (aptk_...). La clave puede reutilizarse hasta el límite de instalaciones de la licencia.

Verifique Docker:

Shell
docker --version
docker compose version
docker ps

Si docker ps falla por permisos, corrija el acceso a Docker antes de continuar. La CLI no necesita root, pero depende de ese acceso.

1. Instale la CLI

Ejecute el comando que se muestra en Aptabit Manager. Tiene esta forma:

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

El script descarga la CLI para el sistema y la arquitectura de la máquina, la verifica con el manifiesto de versión firmado por Aptabit y guarda la configuración de Aptabit Manager en ~/.aptabit/bootstrap.env. En una terminal, ofrece ejecutar aptabit install a continuación.

Confirme la versión:

Shell
aptabit --version

La CLI habla portugués de Brasil e inglés. Pregunta el idioma en la primera ejecución; --lang pt-BR o --lang en cambia la elección.

2. Verifique la máquina

Shell
aptabit check

El informe abarca sistema operativo, memoria y disco, Docker y Compose, GPU y NPU, alcance de Aptabit Manager, confianza en el certificado, reloj y proxy. Un elemento bloqueante detiene la instalación antes de escribir cualquier archivo (código de salida 3). aptabit install ejecuta esta verificación automáticamente.

3. Instale la plataforma

Shell
aptabit install

El instalador pregunta la ubicación de la instalación, el puerto HTTP y el nombre de la organización, con valores predeterminados para un único servidor. En una máquina nueva:

  1. Crea la identidad de la instalación: un par de claves Ed25519 generado en la propia máquina.
  2. Registra el servidor en Aptabit Manager con la clave de instalación. Cuando la licencia exige aprobación, espera la aprobación de Aptabit hasta 20 minutos; ejecutar aptabit install de nuevo retoma desde donde se detuvo.
  3. Genera los archivos de la instalación e inicia el stack.

install es seguro de repetir. Con una instalación existente, actualiza en el lugar y conserva los datos. Eliminar una instalación requiere el comando avanzado aptabit uninstall, que solicita escribir la ruta de la instalación para confirmar.

Cada instalación queda en una carpeta propia:

Texto
<instalacion>/
  config.yaml          # fuente de verdad de la instalación
  docker-compose.yml   # generado a partir de config.yaml
  identity/            # identidad de la instalación (clave privada local)

4. Complete el primer acceso

Al terminar, aptabit install indica la dirección de la página /setup. En ella, cree la organización y la cuenta del propietario. Con clave de instalación no hay token que informar: la licencia ya está vinculada a la instalación.

Lo mismo puede hacerse desde la terminal, con las mismas verificaciones de la página:

Shell
aptabit setup

Para automatización, sin preguntas:

Shell
aptabit setup \
  --config /opt/aptabit/produccion/config.yaml \
  --tenant-name "Mi Organización" \
  --email owner@example.com \
  --display-name "Owner" \
  --password-stdin < contrasena-owner.txt

Proporcione la contraseña con --password-stdin o con la variable APTABIT_SETUP_PASSWORD. Una contraseña en la línea de comandos queda en el historial del shell y en la lista de procesos. La contraseña debe tener al menos 12 caracteres.

La cuenta creada en el setup es la cuenta root: siempre inicia sesión con correo y contraseña, nunca participa del SSO y es el camino de regreso si el proveedor de identidad falla. Consulte Usuarios, roles y acceso.

Para saber si el setup sigue pendiente:

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

5. Verifique y acceda

Shell
aptabit status
aptabit license

Abra http://<servidor>:8080 en el navegador e inicie sesión con la cuenta del propietario. El proxy de la plataforma atiende HTTP; para HTTPS, publique la plataforma detrás del balanceador o del proxy inverso de su organización.

Próximos pasos

  1. En Configuración > Modelos, conecte un proveedor externo o despliegue un modelo local y habilítelo en un workspace. Consulte Modelos, runtimes y aceleradores.
  2. En Almacenamiento, cree un contexto de conocimiento y cargue los primeros documentos. Consulte Almacenamiento.
  3. En Configuración > Usuarios y acceso, registre a las personas, conceda los módulos y, si lo desea, configure el SSO.
  4. En Flujos, comience con una de las 30 plantillas de flujo. Consulte Flujos y programaciones.

Documentaciónv3.7