Skip to main content

Instalação do Docker

O Docker é uma plataforma que permite rodar aplicações dentro de "contêineres" — ambientes isolados e padronizados que funcionam de forma independente do sistema operacional. É através dele que o sistema será executado no servidor.

Pré-requisito: Você deve estar logado como administrador (sudo su). Se ainda não fez isso, execute sudo su antes de continuar.

⚠️ Limite de memória obrigatório. A imagem do sistema traz a mitigação das falhas de segurança do PHP CVE-2026-109618 e CVE-2026-109619. Por causa dela, o PHP roda sem teto de memória e quem limita o consumo é o contêiner. Sem limite de memória, o contêiner não sobe. O script pergunta esse valor no passo 5.

1. Abrindo o Terminal como Administrador

sudo su

2. Instalar o Docker e o Docker Compose

O comando abaixo instala dois componentes:

apt install docker.io -y && \
apt install docker-compose

O que cada um faz:

  • docker.io — o Docker em si, responsável por criar e executar os contêineres
  • docker-compose — ferramenta que permite iniciar e gerenciar vários contêineres de uma só vez usando um arquivo de configuração

3. Clonar o Repositório de Instalação

Agora vamos baixar os arquivos necessários para configurar o ambiente. Acesse a pasta /opt e faça o clone do repositório:

cd /opt && \
git clone https://git.pdv.moda/desenvolvimento/docker.git -b illi-prod illi-prod

Quando solicitado, digite seu usuário e senha de acesso ao git.pdv.moda e pressione Enter após cada um.

Tela de autenticação do git.pdv.moda

O que esse comando faz: Baixa os arquivos de configuração do ambiente Docker a partir do repositório oficial da Illimitar, salvando-os na pasta illi-prod dentro de /opt.

4. Acessar a Pasta Clonada

Após o clone ser concluído, entre na pasta que foi baixada:

cd illi-prod

Dentro dessa pasta estará o arquivo illi.sh, que é o script responsável por instalar e configurar o ambiente.

5. Executar o Script de Instalação

Execute o script com o comando abaixo:

bash illi.sh

O script fará algumas perguntas para configurar a instância. Responda conforme indicado:

  • Nome da instância: illi
  • Porta do host [8088]: pressione Enter para manter a porta padrão 8088
  • Limite de memória do container [4g]:container: pressione Enter para manter 4g, ou informeaceitar o valor dasugerido pelo script (tabela abaixoabaixo)

O que é uma instância? É o nome que identifica esta instalação do sistema no servidor. O nome illi é o padrão recomendado.

O que é a porta 8088? É o número pelo qual o sistema será acessado no navegador. Por exemplo: http://IP-do-servidor:8088. Mantenha o padrão a menos que essa porta já esteja em uso.

O que é o limite de memória? É o máximo de memória RAM que o contêiner do sistema pode usar. É obrigatório: sem ele, o contêiner não sobe. O script mostra a RAM do servidorservidor, sugere o valor e não aceita um limite igual ou maior que ela.a RAM.

Quando o MySQL roda no mesmo servidor, o sistema (web) fica com até 30% da RAM e o banco com o restante (70% ou mais). O script já sugere o valor certo para o servidor:

RAM do servidor Limite do contêiner (web)
Fica para o banco 8 GB ou mais 4g2g (recomendado)6 GB 616 GB 3g4g 12 GB 432 GB 2g8g 24 GB 64 GB 16g 48 GB

SeAcima de 64 GB, a regra continua: o MySQLlimite rodadobra noa mesmocada servidor,vez deixeque peloa menosRAM 2dobra (128 GB livres→ para32g).

ele

A configuração de memória do MySQL (innodb_buffer_pool_size e parademais) odeve sistemacaber operacional.na parte do banco. Veja a página Instalação do Percona MySQL.

O valor fica gravado no .env da instância (ILLI_MEM_LIMIT). Para alterar depois, use as opções 16) Configurar e 13) Reconstruir container do menu.

6. Confirmar a Inicialização do Contêiner

Após configurar a instância, o script fará o clone do repositório standalone automaticamente. Ao final, ele perguntará se deseja subir o contêiner:

  Nome da instância [illi-web]: illi
  Porta do host [8088]: 8088
  Limite de memória do container: obrigatório (mitigação CVE-2026-109618).
  Recomendado: 4g.
  RAM do servidor: 15890 MB. DeixeCom folgaMySQL no mesmo servidor: até 30% para o sistemaweb e(4g), o MySQL.resto para o banco.
  Limite de memória do container [4g]: 4g
  Clonando repositório standalone em www/illi...
Cloning into '/opt/illi-prod/illi/www/illi'...
  ...
  ✔  Repositório clonado em illi/www/illi
  ✔  Host: chmod +x *.sh  |  chown www-data:www-data
  ────────────────────────────────────
  ✔  Instância criada em: /opt/illi-prod/illi
    Container : illi
    Porta     : 8088
    Memória   : 4g
  ────────────────────────────────────
  Subir o container agora? [S/n]:

Responda S e pressione Enter para iniciar o contêiner.

O Docker irá baixar as imagens necessárias e iniciar todos os serviços. Esse processo pode levar alguns minutos dependendo da velocidade da conexão.

Digite 0 para sair do utilitário:

Menu do utilitário illi

7. Conferir o Contêiner

docker ps
docker inspect illi --format '{{.HostConfig.Memory}}'
  • Em docker ps, o STATUS deve ser Up. Se aparecer Restarting, veja Problemas comuns abaixo.
  • O docker inspect deve mostrar um número diferente de 0 (o limite em bytes). Para 4g, aparece 4294967296.

✅ Instalação Concluída

O Docker está instalado e o contêiner do sistema está em execução. O ambiente estará acessível pelo navegador no endereço http://IP-do-servidor:8088.

Problemas comuns

Contêiner reiniciando sem parar (Restarting)

Ao rodar docker logs illi, aparece:

[erro] container sem limite de memória (exigido pela mitigação CVE-2026-109618).

Causa: a instância foi criada sem limite de memória, com uma versão do illi.sh anterior à mitigação.

Solução:

cd /opt/illi-prod && git pull
bash illi.sh
  1. Escolha a instância.
  2. Escolha 13) Reconstruir container e confirme.
  3. InformeQuando o script pedir o limite de memóriamemória, quandopressione Enter para aceitar o scriptvalor pedir.sugerido (tabela do passo 5).

O script atualiza os arquivos da instância, guarda o docker-compose.yml antigo como backup (docker-compose.yml.bak-<data>) e recria o contêiner com o limite. Depois, confira com o passo 7.

Próximo Passo

Continue para: Configuração da Interface