Instalação Local - strattum.ai

A instalação local é destinada a avaliação, desenvolvimento e testes. Para ambientes de produção, consulte os guias de instalação em AWS, GCP ou Azure.

Pré-requisitos

Antes de começar, verifique se sua máquina atende aos requisitos:

Requisito	Mínimo	Recomendado
CPU	4 vCPU	8 vCPU
RAM	16 GB	32 GB
Disco	50 GB livres	100 GB livres
Docker	24.x+	Última versão estável
Docker Compose	v2.x+	Última versão estável

Em Mac com chip Apple Silicon (M1/M2/M3), o Docker Desktop precisa estar com Rosetta habilitado para algumas imagens. Acesse Docker Desktop → Settings → General → “Use Rosetta for x86/amd64 emulation”.

Instalação

Clone o repositório de deploy

git clone https://github.com/strattum-ai/strattum-deploy.git
cd strattum-deploy/starter

Configure as variáveis de ambiente

Copie o arquivo de exemplo e preencha as variáveis obrigatórias:

cp .env.example .env

Abra o .env e preencha no mínimo:

# Senha do PostgreSQL — use um valor forte
POSTGRES_PASSWORD=minha-senha-segura

# DSN completo (use a mesma senha acima)
POSTGRES_DSN=postgresql://strattum:minha-senha-segura@strattum-postgres:5432/strattum

# URL do Prefect (mesma senha)
PREFECT_API_DATABASE_CONNECTION_URL=postgresql+asyncpg://strattum:minha-senha-segura@strattum-postgres:5432/prefect

# Provider de LLM — necessário para Knowledge e para os agentes que executam Skills
LLM_PROVIDER=openai
LLM_API_KEY=sk-...
LLM_MODEL=gpt-4o

# Chave Anthropic — necessária para as funcionalidades de IA no Console [verificar: uso exato da chave]
STRATTUM_ANTHROPIC_API_KEY=sk-ant-...

# Domínio local (para desenvolvimento)
TRAEFIK_DOMAIN=localhost
TRAEFIK_ACME_EMAIL=seu@email.com

# Zitadel (identity provider)
ZITADEL_DOMAIN=localhost
ZITADEL_MASTERKEY=uma-chave-de-exatamente-32-chars!

# Registry — deixe vazio para build local
REGISTRY=strattum

Para gerar valores seguros: openssl rand -hex 32 (para senhas e secrets) e openssl rand -base64 32 | head -c 32 (para o ZITADEL_MASTERKEY).

Crie a rede Docker e os diretórios obrigatórios

# Rede interna compartilhada entre todos os serviços
docker network create strattum-network

# Diretório de secrets (credenciais de conectores)
mkdir -p secrets
echo '{}' > secrets/connector_registry.json
touch secrets/gcp-sa.json

# Diretório de configuração de conectores
mkdir -p config/connectors
mkdir -p config/memory

Suba a plataforma

docker compose up -d

O primeiro boot leva 2–5 minutos enquanto as imagens são baixadas e os serviços inicializam. Acompanhe o progresso:

docker compose logs -f

Aguarde até ver as mensagens de saúde dos serviços principais.

Verifique a saúde dos serviços

Execute o script de healthcheck incluído:

./healthcheck.sh

Ou verifique manualmente cada API:

# Catalog API
curl http://localhost:8001/health

# Memory API
curl http://localhost:8002/healthz

# Knowledge API
curl http://localhost:8003/healthz

# MCP Server
curl http://localhost:8005/healthz

# Console UI
curl http://localhost:3000/api/health

Todos devem retornar 200 OK.

Acessando a plataforma

Após subir todos os serviços:

Serviço	URL local	Descrição
Console UI	http://localhost:3000	Interface principal da plataforma
Prefect UI	http://localhost:4200	Orquestração de pipelines
PostgreSQL	localhost:5432	Banco de dados interno
FalkorDB	localhost:6380	Graph store (Memory)
Qdrant	localhost:6333	Vector store (Knowledge)

No primeiro acesso ao Console UI, você será redirecionado para a tela de login do Zitadel. O usuário administrador inicial é criado automaticamente — consulte os logs do container strattum-zitadel para obter a senha inicial: docker compose logs zitadel | grep -i "initial\|admin\|password".

Configuração inicial do Zitadel

O Zitadel é o identity provider da plataforma. Para o ambiente local:

Acesse o Zitadel

Abra http://localhost:8080 no navegador.

Crie o primeiro usuário administrador

Navegue até Users → New User e crie o usuário que será usado para acessar o Console.

Configure o client OIDC

Em Applications, configure o client para o Console UI com:

Redirect URI: http://localhost:3000/api/auth/callback/zitadel
Post Logout URI: http://localhost:3000

Copie o Client ID e Client Secret gerados e adicione ao .env:

ZITADEL_CLIENT_ID=<client-id>
ZITADEL_CLIENT_SECRET=<client-secret>
NEXTAUTH_URL=http://localhost:3000

Reinicie o Console UI

docker compose restart strattum-console-ui

Comandos úteis

# Ver status de todos os containers
docker compose ps

# Ver logs de um serviço específico
docker compose logs -f strattum-memory-api

# Reiniciar um serviço
docker compose restart strattum-knowledge-api

# Parar toda a plataforma (preserva dados)
docker compose down

# Parar e remover volumes (apaga todos os dados)
docker compose down -v

Próximos passos

Com a plataforma rodando, configure suas primeiras integrações:

Configuração pós-instalação

Conecte fontes de dados, configure a ontologia e ative o pipeline de contexto.

Conectores disponíveis

Veja todos os conectores suportados e como configurar cada um.

​Pré-requisitos

​Instalação

​Acessando a plataforma

​Configuração inicial do Zitadel

​Comandos úteis

​Próximos passos

Configuração pós-instalação

Conectores disponíveis

Pré-requisitos

Instalação

Acessando a plataforma

Configuração inicial do Zitadel

Comandos úteis

Próximos passos