Instalando o Evolution-API na nova ISO com kernel 6.6

Antes de seguir o passo a passo, use a nova ISO baixando no link: https://iso.mk-auth.com.br/mk-auth.iso
 
O MK-Auth está visando novas implementações e melhorias para o futuro que só serão possíveis com o novo kernel.
Agora, vamos iniciar um projeto bem fácil e rápido (sem sair bagunçando todo o sistema).

 

Instalando o Evolution API

O Evolution API é um projeto que visa facilitar a integração com WhatsApp e é um projeto open-source.
Documentação do projeto: [Evolution API]

 

1. O Docker já está instalado na nova ISO, então basta colar o código abaixo no terminal.
Acesse o terminal via SSH, que pode ser pelo PuTTY ou pelo terminal do Linux.

 

docker run -d \
--name evolution_api \
-p 7070:8080 \
-e AUTHENTICATION_API_KEY=1234 \
atendai/evolution-api:v1.8.2

 

O código acima irá baixar a imagem do Evolution API e iniciar o container.


12862186669?profile=RESIZE_710xLembre-se de trocar o '1234' por uma senha segura, pois essa senha será usada para acessar o painel de controle do Evolution API.

2. Agora acesse o IP da sua máquina na porta 7070.
Como abaixo:
entrando no manager http://{seu_ip}:7070/manager

fetch.php?media=evolution_mk.gif

3. Agora acesse o painel de controle com a senha que você definiu no passo 1.

 

4. Agora clique no botão de INSTÂNCIA e defina o nome da instância com qualquer nome que desejar.
12862191062?profile=RESIZE_710x

 

- Usaremos 'mk-whatsapp' nesse campo. Esse campo é usado no webAdmin do MK-Auth.
- Selecione 'Integração Baileys'.
- Vamos usar a API key que o Evolution API forneceu. Esse campo também será usado no webAdmin do MK-Auth.
- Clique em salvar.

 

5. Agora selecione a Instancia criada e verá a tela abaixo, clique em CONECTAR. Irá aparecer um QRCode, escaneie o QRCode com o WhatsApp do seu celular.
12862202701?profile=RESIZE_710x
12862199297?profile=RESIZE_710x

 

6. Agora acesse o webAdmin do MK-Auth e vá em Opções -> Servidor de WhatsAPP. Vá para a aba Servidor e selecione 'Evolution API'.
Como abaixo, só seguir usando o que foi feito anteriormente.

12862207064?profile=RESIZE_710x

7. Agora basta ir em CLIENTES -> Lista todos, selecionar o cliente e clicar no botão de Envelope. Em seguida, selecione a opção de WhatsApp. Pronto, o cliente receberá uma mensagem no WhatsApp. Qualquer erro ou dúvida, o tópico foi criado para isso.
 
 

 Nova ISO com Docker

Para adicionar comentários, você deve ser membro de MK-AUTH.

Join MK-AUTH

Votos 0
Enviar-me um email quando as pessoas responderem –

Respostas

  • 🌎 Elton Pereira ✅ Suporte / Addons /API Eu estou rodando o docker 20.10.x no meu MK-AUTH TUX 6.12, dei run na imagem da evolution api v1 1.8.7 e funcionou perfeitamente. Minha intenção é compartilhar o motivo do erro e a solução com os interessados em rodar a evoapi v1 ou v2 self-hosted.
    Uma vez q o tópico criado pelo amigo José Santos não se aplica diretamente a nova iso TUX 6.12 (apenas depois da patch)
    Pretendo disponibilizar o patch q eu criei a todos interessados...
    Poderia por favor habilitar a edição do meu post anterior?
    Obrigado.

  • @Zé Luis docker foi descontinuado na 6.12 amigo e evo v1 tambem foi descontinuada sem atualização. 

  • Docker 18.x (docker.io) vs Kernel 6.12 (XanMod): por que funcionava no TUX 6.6 e agora quebra na nova iso? (Direcionado a quem precisar rodar um container docker (ex: evolution-api self-hosted) na iso TUX 6.12)

    🎯 Tese central

    Docker 18.x não é compatível com ambientes onde o cgroup v2 é o controlador efetivo.

    No kernel 6.6, a maioria das distribuições ainda mantém cgroup v1 como hierarquia padrão, o que permite que o Docker 18.x funcione.

    No kernel 6.12 (ex.: XanMod), cgroup v2/híbrido passa a ser o default, e o Docker 18.x falha ao montar a hierarquia de cgroups, resultando em erros como:

    cgroups: cannot find cgroup mount destination


    🧪 Ambiente testado (prova real)

    OS: Devuan GNU/Linux 3 (beowulf)
    Kernel: 6.12.42-x64v1-xanmod1
    Docker: 18.09.1 (docker.io)
    Cgroup driver: cgroupfs
    Cgroup layout exposto: v2 / unified

     

    WARNING: No memory limit support
    WARNING: No cpuset support
    docker: Error response from daemon:
    cgroups: cannot find cgroup mount destination

    E o sistema confirma cgroup v2 ativo:
     
     /sys/fs/cgroup/unified/cgroup.controllers
     

    📊 Comparativo rápido (sem drama)

    Componente Docker 18.x Docker 20.10+ Kernel 6.6 Kernel 6.12
    cgroup v1 ✔️ Funciona ✔️ ✔️ Default em muitas distros ⚠️ Não default
    cgroup v2 ❌ Não suporta ✔️ Suporte completo ✔️ ✔️ Default
    containerd moderno ✔️ ✔️ ✔️
    runc moderno ✔️ ✔️ ✔️
    Docker stats / limits ❌ Parcial ✔️ ✔️ ✔️

    ➡️ Conclusão prática: não é “bug do kernel”, é incompatibilidade de geração.


    🤔 “Mas funcionava no kernel 6.6”

    Sim — e isso é esperado.

    • Kernel 6.6 → cgroup v1 ainda comum por padrão

    • Kernel 6.12 (XanMod) → cgroup v2/híbrido ativo por padrão

    • Docker 18.xnão sabe lidar com cgroup v2 como controlador efetivo

    Ou seja: 👉 o kernel evoluiu, o Docker 18.x ficou para trás...


    ✅ Soluções recomendadas 

    Atualização

    • Docker 20.10+

    • containerd ≥ 1.4

    • runc moderno ✔️ Compatível com kernel 6.12
      ✔️ Suporte total a cgroup v2

     


    📌 Nota sobre Evolution API no Kernel 6.12

    • Evolution API v1 → requer Docker 20.10

    • Evolution API v2 → requer Docker 20.10+ e Compose v2 ➡️ Atualizar Docker é o caminho natural e suportado


    🧠 Conclusão

    O problema não é o XanMod 6.12, nem o Devuan.

    Docker 18.x não é compatível com ambientes onde o cgroup v2 é o controlador efetivo.

    No kernel 6.6, a maioria das distribuições ainda mantém cgroup v1 como hierarquia padrão, o que permite que o Docker 18.x funcione normalmente.

    A partir do kernel 6.12 (ex.: XanMod), o sistema passa a expor cgroup v2 ou modo híbrido como padrão, e o Docker 18.x falha ao montar a hierarquia de cgroups, resultando em erros como:

    cgroups: cannot find cgroup mount destination

    O problema é tentar usar o Docker 18.x em um kernel moderno (6.12) com cgroup v2 ativo, algo que não é mais suportado upstream.

     

    ### Links oficiais de documentação e changelogs

    **Kernel Documentation — cgroup v2 (unified hierarchy)**
    https://docs.kernel.org/admin-guide/cgroup-v2.html

    **Kernel 6.12 full changelog (cgroup-related)**
    https://cdn.kernel.org/pub/linux/kernel/v6.x/ChangeLog-6.12

    **Kernel 6.6 full changelog (para comparação)**
    https://cdn.kernel.org/pub/linux/kernel/v6.x/ChangeLog-6.6

    **Docker cgroup v2 support docs**
    https://docs.docker.com/engine/security/cgroup-v2/

    **Artigo explicativo sobre transição de cgroup**
    https://lwn.net/Articles/776116/

  • Amigos precisei remover o docker da ISO, mais criei um mini tutorial de como instalar o evolution-api já na versão 2 na railway, está no link abaixo e obrigado:

    https://mk-auth.com.br/forum/topics/evolution-api-v2-no-railway-em-...

  • a v2,0 nao é tao simples quanto a v1 pra v2 aconselho uma vps ou servidor so pra ela

     

  • Elton P. Nascimento Batista

    se for só pra integrar com o mk-auth a v1 atende muito bem.

    Elton P. Nascimento Batista
    Controle WEB de provedores com MikroTik
  • ai vc teve que instalar o docker na tux4.19

  • Boa noite A&T Telecom - Anderson Paura

    tem que instalar a nova iso atualiza nao atualiza o tux e se vc tiver atualizado na tux 4.19 o bkp funciona sim.

    A&T Telecom - Anderson Paura
    Controle WEB de provedores com MikroTik
  • Tenho visto muita gente postando sobre como rodar a evolutiion-api via docker ... e dessa foma que José fez é bem mais técnica, exige conhecimentos de docker via linha de comando.

    Assim que puder vou subir um how to, talvez em vídeo, de como instalar o portainer que é uma interface gráfica (front) pra gerenciar visualmente o docker, bem como os principais serviços para rodar a evolution-api que são o banco de dados postgres, o redis e a própria evolution versão 2.

  • Olá, está usando a nova ISO? Nela, o Docker já vem instalado. Nas versões antigas, ocorrerá o erro de comando não encontrado.

This reply was deleted.