Como Instalar DokuWiki no Debian 12

DokuWiki é um software wiki simples e versátil de código aberto que não requer um banco de dados. É conhecido por sua facilidade de manutenção, legibilidade e gerenciamento de usuários, tornando-o ideal para criar e gerenciar documentação em ambientes corporativos ou colaborativos. Alimentado por PHP, seu software wiki versátil e os controles de acesso integrados (ACL) suportam os principais drivers de autenticação. O DokuWiki oferece uma administração fácil, é fácil de instalar, manter e fazer backup de um host para outro.

Neste guia, vamos orientá-lo na instalação do DokuWiki no servidor Debian 12. Você instalará o DokuWiki com a pilha LAMP (Apache2, MariaDB e PHP), UFW e certificados SSl/TLS via Letsencrypt.

Pré-requisitos

Certifique-se de ter o seguinte para prosseguir com este guia:

• Um servidor Debian 12.
• Um usuário não-root com privilégios de administrador.
• Um nome de domínio apontado para o endereço IP do servidor.

Instalando Dependências

Por padrão, o pacote DokuWiki está disponível no repositório Debian. Mas, para garantir que você tenha a versão mais recente do DokuWiki instalada, você instalará o DokuWiki manualmente no seu servidor Debian.

Nesta seção, você instalará as dependências para o DokuWiki, incluindo os pacotes da pilha LAMP (Apache2, MariaDB e PHP), UFW e Certbot.

Antes de começar, atualize seu repositório Debian usando o comando abaixo.

sudo apt update

Instale os pacotes da pilha LAMP, UFW e Certbot usando o seguinte comando apt install. Digite Y e pressione ENTER quando solicitado.

sudo apt install apache2 mariadb-server php libapache2-mod-php php-xml php-mbstring php-zip php-intl php-gd ufw certbot python3-certbot-apache

Uma vez que a instalação esteja concluída, verifique o status do serviço Apache e MariaDB para garantir que o serviço esteja em execução.

Execute o seguinte comando para verificar o serviço apache2.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Quando o apache2 estiver em execução, você deve obter uma saída ‘ativo (em execução)’. E a saída ‘habilitado’ confirma que o apache2 será iniciado na inicialização do sistema.

Agora execute o seguinte comando para verificar o serviço mariadb.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Certifique-se de que o serviço mariadb esteja ‘habilitado’ e ‘ativo (em execução)’ na sua máquina Debian.

Configurando UFW

Neste guia, você irá proteger seu servidor Debian com UFW (Firewall Descomplicado). Nesse caso, você deve abrir a porta SSH para seu acesso remoto e as portas para os protocolos HTTP e HTTPS para executar a instalação do DokuWiki.

Execute o seguinte comando para adicionar os perfis OpenSSH e ‘WWW Full‘ ao UFW.

O perfil OpenSSH abrirá a porta SSH padrão 22, enquanto o perfil ‘WWW Full’ abre as portas HTTP e HTTPS.

sudo ufw allow OpenSSH  
sudo ufw allow 'WWW Full'

Agora, execute o seguinte comando para iniciar e habilitar o UFW na sua máquina Debian.

sudo ufw enable

Digite y quando solicitado para confirmar, e você deve obter uma saída como ‘O Firewall está ativo e habilitado na inicialização do sistema‘. O UFW será executado automaticamente na inicialização do sistema.

Por último, execute o seguinte comando para verificar o status do UFW. Certifique-se de que os perfis OpenSSH e ‘WWW Full’ estão listados nas suas regras habilitadas do UFW.

sudo ufw status

Configurando php.ini

Na seção seguinte, você irá configurar o PHP modificando o arquivo php.ini padrão e ajustando algumas das configurações para a instalação do DokuWiki.

Execute o seguinte comando do editor nano para abrir o arquivo de configuração PHP ‘/etc/php/8.2/apache2/php.ini‘.

sudo nano /etc/php/8.2/apache2/php.ini

Altere a configuração padrão com o seguinte. Certifique-se de ajustar o parâmetro memory_limit com a RAM atual do seu servidor.

memory_limit=256M  
upload_max_filesize=32M  
post_max_size=32M  
max_execution_time=60

Salve e feche o arquivo quando terminar.

Agora, execute o comando systemctl abaixo para reiniciar o serviço apache2 e aplicar os efeitos das suas alterações.

sudo systemctl restart apache2

Configurando o Servidor MariaDB

Agora que você configurou o PHP, o próximo passo é configurar a instalação do seu servidor MariaDB, e então criar um novo banco de dados e usuário que usarão o DokuWiki.

Inicie o processo de configuração do MariaDB executando o comando mariadb-secure-installation abaixo.

sudo mariadb-secure-installation

Digite Y quando solicitado para aplicar a nova configuração ao MariaDB, ou você também pode digitar n para Não para rejeitá-la. Abaixo estão algumas das configurações do MariaDB que você será solicitado:

• A instalação padrão do MariaDB vem sem uma senha, pressione ENTER quando solicitado pela senha.
• Agora digite Y para configurar a senha root do MariaDB. Em seguida, digite a nova senha para o MariaDB e repita a senha.
• Digite Y para remover o usuário anônimo da sua instalação do MariaDB.
• Digite Y novamente quando solicitado para desabilitar o login remoto para o usuário root do MariaDB.
• Digite Y para remover o banco de dados de teste padrão da sua instalação do MariaDB.
• Por último, digite Y para recarregar os privilégios da tabela e aplicar novas alterações.

Após a configuração do MariaDB ser concluída, você precisa criar um novo banco de dados e usuário que serão usados pelo DokuWiki.

Faça login no servidor MariaDB executando o comando mariadb abaixo. Digite sua senha root do MariaDB quando solicitado.

sudo mariadb -u root -p

Agora execute as seguintes consultas para criar um novo banco de dados dokuwikidb, usuário dokuwiki, com a senha ‘p4ssword‘. Certifique-se de alterar a senha para sua nova senha.

CREATE DATABASE dokuwikidb;  
CREATE USER dokuwiki@localhost IDENTIFIED BY 'p4ssword';  
GRANT ALL PRIVILEGES ON dokuwikidb.* TO dokuwiki@localhost;  
FLUSH PRIVILEGES;

Em seguida, verifique o usuário dokuwiki para garantir os privilégios ao banco de dados dokuwikidb.

SHOW GRANTS FOR dokuwiki@localhost;

Na saída a seguir, você configurou o usuário dokuwiki com todos os privilégios para o banco de dados dokuwikidb.

Por último, digite quit para sair do servidor MariaDB e passar para o próximo passo.

Baixando o Código Fonte do DokuWiki

Nesta seção, você irá baixar o código fonte do DokuWiki e configurar o diretório de instalação com as permissões adequadas.

Vá para o diretório /var/www/ e baixe a versão estável mais recente do DokuWiki usando o comando wget abaixo.

cd /var/www/  
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz

Agora extraia o arquivo dokuwiki-stable.tgz e renomeie o diretório extraído para dokuwiki. Isso significa que seu diretório de instalação do DokuWiki estará disponível em /var/www/dokuwiki.

tar xzvf dokuwiki-stable.tgz  
sudo mv dokuwiki-*a dokuwiki

Por último, execute o comando abaixo para alterar a propriedade do diretório /var/www/dokuwiki para o usuário www-data e grupo www-data. Dessa forma, seu servidor web Apache2 poderá ler o código fonte do DokuWiki.

sudo chown -R www-data:www-data /var/www/dokuwiki

Configurando o Host Virtual do Apache2

Após baixar o DokuWiki, você agora criará um novo arquivo de host virtual do Apache2 para executar o DokuWiki. Certifique-se de que seu nome de domínio esteja pronto antes de começar. Neste exemplo, usaremos o domínio wiki.howtoforge.local.

Agora, execute o comando do editor nano abaixo para criar uma nova configuração de host virtual do Apache2 /etc/apache2/sites-available/dokuwiki.conf.

sudo nano /etc/apache2/sites-available/dokuwiki.conf

Insira a seguinte configuração e certifique-se de alterar o nome do domínio wiki.howtoforge.local para o seu domínio.

  
    ServerName    wiki.howtoforge.local        
    DocumentRoot  /var/www/dokuwiki  
  
      
          
            AllowOverride All  
            Require all denied  
          
          
            Order allow,deny  
            Deny from all  
          
      
  
    ErrorLog   /var/log/apache2/wiki.howtoforge.local_error.log  
    CustomLog  /var/log/apache2/wiki.howtoforge.local_access.log combined  

Quando terminar, salve e feche o arquivo.

Em seguida, execute o seguinte comando para habilitar o host virtual dokuwiki.conf e verificar sua sintaxe do Apache para garantir que não haja erro.

sudo a2ensite dokuwiki.conf  
sudo apachectl configtest

Se você tiver a sintaxe correta e não houver erro, verá uma saída ‘Sintaxe OK‘.

Por último, execute o comando abaixo para reiniciar o servidor Apache2 e aplicar suas modificações.

sudo systemctl restart apache2

Protegendo o DokuWiki com Certificados SSL/TLS

Neste ponto, seu DokuWiki está em execução e acessível. Mas para garantir que sua instalação esteja segura, você irá configurar certificados SSl/TLS via Letsencrypt.

Execute o comando certbot abaixo para gerar certificados SSL/TLS para o seu nome de domínio DokuWiki. Certifique-se de alterar o endereço de e-mail e o nome do domínio com suas informações.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d wiki.howtoforge.local

Uma vez que o processo esteja concluído, sua instalação do DokuWiki deve estar automaticamente configurada com HTTPS. E seus certificados SSL/TLS devem estar disponíveis no diretório /etc/letsencrypt/live/seudominio.com.

Instalando o DokuWiki via Instalador Web

Abra seu navegador e visite seu nome de domínio para a instalação do DokuWiki, como https:/wiki.howtoforge.local/install.php. Você deve ver o instalador web do DokuWiki.

Selecione a opção Habilitar ACL, insira seu usuário admin, e-mail e senha para o DokuWiki, e clique em Salvar.

Uma vez que a instalação seja bem-sucedida, você deve obter uma saída ‘A configuração foi concluída com sucesso.‘.

Agora volte para seu terminal e exclua o script install.php usando o comando abaixo.

sudo rm /var/www/dokuwiki/install.php

Em seguida, clique no link ‘seu novo DokuWiki‘ para continuar. E você deve obter a página inicial do DokuWiki como a seguinte.

Agora clique no botão Login e você deve obter a página de login do DokuWiki como a seguinte.

Insira seu usuário admin e senha, e clique em Log in. Quando bem-sucedido, você deve ser apresentado ao painel do DokuWiki.

Conclusão

Parabéns! Você agora completou a instalação do DokuWiki no servidor Debian 12. Você instalou o DokuWiki com a pilha LAMP (Apache2, MariaDB e PHP). Você também protegeu sua instalação do DokuWiki com UFW (Firewall Descomplicado) e certificados SSL/TLS do Letsencrypt.