Alfresco / MANUAL TÉCNICO

Instalar Alfresco em Debian e Docker

Roteiro de laboratório com Compose fixado, pré-requisitos, comandos, verificações e diagnóstico.

Editora: Arquindex · Revisado em 06/11/2026Ler em Markdown ↗

Procedimento de laboratório. Comandos documentados; instalação do stack não executada nesta revisão.

Resposta direta

A implantação Docker exige o projeto completo acs-deployment, imagens compatíveis e persistência configurada. O exemplo usa a tag v10.9.0 em laboratório; ele não substitui o desenho de produção.

Pré-requisitos e escopo do procedimento

Servidor ou VM de laboratório com acesso administrativo, Git e Docker Compose v2.
Rede e portas livres; recursos compatíveis com o conjunto de serviços.
Sem acervo de produção neste laboratório. O procedimento não executa migração de dados.

Para instalar o Docker no Debian, configure o repositório APT indicado na documentação oficial Docker, conferindo sua versão e arquitetura. Após configurar o repositório:

Debian · instalação dos pacotes Docker

sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin git
sudo docker version
sudo docker compose version

Use sudo docker se sua conta não tiver acesso ao daemon. Não altere a permissão do socket para liberar acesso irrestrito.

Exemplos para preparar um laboratório novo e isolado. Os comandos não foram executados em um servidor Alfresco nesta revisão. Tenha Git e Docker Engine com Compose v2 instalados pelo canal adequado ao sistema.

Método	O que entrega	Uso e limites
Docker Compose	Serviços descritos em YAML e imagens por componente	Reproduzir um conjunto fixado, revisar portas, volumes e segredos.
ZIP / WAR	Aplicações e recursos para montar a pilha manualmente	Instalar Java, Tomcat, banco, busca, transformações e demais dependências da versão.
Ansible	Automação de instalação Linux	Usar o playbook e distribuições previstos pelo projeto; não executar roteiro Ubuntu cegamente no Debian.
Helm / Kubernetes	Recursos de orquestração	Requer operação de cluster, persistência e compatibilidade dos charts; não é atalho de estabilidade.
Windows	ZIP/manual compatível ou VM Linux para Docker	Separar versão do Windows Server, runtime Java/Tomcat e ferramentas externas. Não prometer .exe atual sem artefato publicado.

Preparar referência v10.9.0 · Bash

git --version
docker version
docker compose version
git clone --branch v10.9.0 --depth 1 https://github.com/Alfresco/acs-deployment.git alfresco-lab
cd alfresco-lab/docker-compose
docker compose -f community-compose.yaml config --quiet
# Revisar YAML, arquivos commons/, portas e persistência antes do start.
docker compose -f community-compose.yaml pull
docker compose -f community-compose.yaml up -d
docker compose -f community-compose.yaml ps

Laboratório com Docker em contêineres Linux · PowerShell

git --version
docker version
docker compose version
git clone --branch v10.9.0 --depth 1 https://github.com/Alfresco/acs-deployment.git alfresco-lab
Set-Location alfresco-lab/docker-compose
docker compose -f community-compose.yaml config --quiet
# Confirmar backend Linux/WSL2 e recursos alocados ao Docker.
docker compose -f community-compose.yaml pull
docker compose -f community-compose.yaml up -d
docker compose -f community-compose.yaml ps

O Compose de referência inclui senhas de demonstração, serviços com portas publicadas e configurações destinadas ao laboratório. Para produção, faça o desenho de rede e TLS, substitua credenciais e segredos de forma coerente e defina volumes persistentes explícitos com restauração testada. Preserve todos os arquivos auxiliares: baixar só o YAML principal é insuficiente.

Instaladores e automação de implantação

Playbooks Ansible Linux ↗ · Gerador Docker Compose ↗ · Helm charts ↗ · Instalador Ubuntu da comunidade ↗

O instalador Ubuntu é um projeto comunitário indicado nas notas, com escopo próprio; não equivale a instalador nativo Debian ou Windows.

Configuração manual: propriedades que se relacionam

Trecho ilustrativo · alfresco-global.properties

# Valores ilustrativos; ajustar à edição, versão e rede.
dir.root=/srv/alfresco/alf_data
db.driver=org.postgresql.Driver
db.url=jdbc:postgresql://postgres:5432/alfresco
db.username=alfresco
# db.password deve ser fornecida por mecanismo protegido da implantação.
alfresco.host=ged.exemplo.com.br
alfresco.port=443
alfresco.protocol=https
share.host=ged.exemplo.com.br
share.port=443
share.protocol=https

O trecho não constitui configuração completa. No Docker, vários ajustes são passados como propriedades JVM em JAVA_OPTS; não suponha que qualquer variável de ambiente vire propriedade automaticamente. Busca, broker e transformadores precisam apontar para os nomes da rede interna. Host/porta públicos devem refletir o proxy.

Diagnóstico inicial

Ler estado e logs · sem remover dados

docker compose -f community-compose.yaml ps
docker compose -f community-compose.yaml logs --tail=100 alfresco
docker compose -f community-compose.yaml logs --tail=100 share
docker compose -f community-compose.yaml logs --tail=100 postgres

Falha de pull: conferir tag, registry, autenticação e arquitetura. JDBC: conferir DNS interno, driver e credenciais. Keystore: preservar os arquivos e segredos ligados ao acervo. Erro 404 em /alfresco: conferir inicialização, contextos e proxy antes de recriar serviços. Logs podem conter dados internos; revisar antes de compartilhar.

Manual de instalação Debian → · Manual de diagnóstico →

Fontes: Compose oficial fixado em v10.9.0 ↗ · Lançamentos de acs-deployment ↗ · Notas Community 26.2 ↗ · Notas Community 25.3 ↗

Resultado esperado

O comando ps deve mostrar os serviços iniciados e saudáveis conforme os healthchecks. Confirme depois autenticação, upload, download, transformação e busca; contêiner em execução sozinho não prova funcionamento do conjunto.

Baixar exemplo: alfresco-laboratorio.sh · Trecho didático para adaptar; não é um instalador completo.