# Instalar Alfresco em Debian e Docker Roteiro de laboratório com Compose fixado, pré-requisitos, comandos, verificações e diagnóstico. Editora: Arquindex. Revisão: 06/11/2026. URL canônica: https://www.arquindex.com.br/open-source-documental/alfresco/instalacao-debian-docker/ Escopo: 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](https://docs.docker.com/engine/install/debian/), conferindo sua versão e arquitetura. Após configurar o repositório: ```text 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étodoO que entregaUso e limites Docker ComposeServiços descritos em YAML e imagens por componenteReproduzir um conjunto fixado, revisar portas, volumes e segredos. ZIP / WARAplicações e recursos para montar a pilha manualmenteInstalar Java, Tomcat, banco, busca, transformações e demais dependências da versão. AnsibleAutomação de instalação LinuxUsar o playbook e distribuições previstos pelo projeto; não executar roteiro Ubuntu cegamente no Debian. Helm / KubernetesRecursos de orquestraçãoRequer operação de cluster, persistência e compatibilidade dos charts; não é atalho de estabilidade. WindowsZIP/manual compatível ou VM Linux para DockerSeparar versão do Windows Server, runtime Java/Tomcat e ferramentas externas. Não prometer .exe atual sem artefato publicado. Debian / LinuxWindows / PowerShell ```text 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 ``` ```text 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 ↗](https://github.com/Alfresco/alfresco-ansible-deployment) · [Gerador Docker Compose ↗](https://github.com/Alfresco/alfresco-docker-installer) · [Helm charts ↗](https://github.com/Alfresco/alfresco-helm-charts) · [Instalador Ubuntu da comunidade ↗](https://github.com/aborroy/alfresco-ubuntu-installer) 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 ```text # 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 ```text 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 →](/open-source-documental/alfresco/instalacao-debian-docker/) · [Manual de diagnóstico →](/open-source-documental/alfresco/instalacao-debian-docker/) Fontes: [Compose oficial fixado em v10.9.0 ↗](https://github.com/Alfresco/acs-deployment/blob/v10.9.0/docker-compose/community-compose.yaml) · [Lançamentos de acs-deployment ↗](https://github.com/Alfresco/acs-deployment/releases) · [Notas Community 26.2 ↗](https://community.hyland.com/kb/articles/1773-alfresco-community-edition-26-2-release-notes) · [Notas Community 25.3 ↗](https://community.hyland.com/kb/articles/1778-alfresco-community-edition-25-3-release-notes) ## 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.