Laboratório: Implantação do OpenEMR integrado ao MySQL e Apache em ambiente local

Duração estimada

120 min

Passos

11

Validações

5

Versões da documentação consultada

OpenEMR 7.0.0 · MySQL Community Server 8.0 · Apache HTTP Server 2.4

Topologia

Uma máquina virtual Linux (192.168.56.10) roda Apache, MySQL e OpenEMR. O acesso ocorre via navegador local ou de outro host na mesma rede privada.

+---------------------+
|   VM Linux          |
| 192.168.56.10       |
|                     |
| +-----------+       |
| | Apache    |       |
| +-----------+       |
| | MySQL     |       |
| +-----------+       |
| | OpenEMR   |       |
+---------------------+
         |
    Navegador local

Equipamentos e software

Roteiro

1. Atualizar o sistema operacional

   Antes de instalar qualquer software, garanta que o sistema está atualizado para evitar conflitos e vulnerabilidades.

   sudo apt update && sudo apt upgrade -yCopiar

   O que você deve ver: O sistema aplica atualizações e retorna ao prompt sem erros.

2. Instalar Apache

   O OpenEMR é uma aplicação web. Precisa de um servidor HTTP robusto. Apache é o mais documentado para OpenEMR.

   sudo apt install apache2 -yCopiar

   O que você deve ver: Apache instalado. Serviço 'apache2' ativo (verifique com 'systemctl status apache2').

3. Instalar MySQL Server

   O OpenEMR armazena dados clínicos em um banco relacional. MySQL é suportado oficialmente.

   sudo apt install mysql-server -yCopiar

   O que você deve ver: MySQL instalado. Serviço 'mysql' ativo (verifique com 'systemctl status mysql').

4. Configurar usuário e banco de dados do OpenEMR no MySQL

   Separar o banco e o usuário do OpenEMR aumenta a segurança e facilita backups.

   sudo mysql -u root
   CREATE DATABASE openemr CHARACTER SET utf8 COLLATE utf8_general_ci;
   CREATE USER 'openemruser'@'localhost' IDENTIFIED BY 'senha_forte';
   GRANT ALL PRIVILEGES ON openemr.* TO 'openemruser'@'localhost';
   FLUSH PRIVILEGES;
   EXIT;Copiar

   O que você deve ver: Banco de dados e usuário criados sem erros.

5. Instalar dependências PHP

   O OpenEMR exige PHP e módulos específicos. Sem eles, a aplicação não roda.

   sudo apt install php php-mysql php-gd php-xml php-mbstring php-curl php-zip php-soap php-intl php-json -yCopiar

   O que você deve ver: PHP e módulos instalados. Verifique com 'php -v'.

6. Baixar e extrair o OpenEMR

   O código-fonte do OpenEMR está disponível no site oficial. Use sempre a versão estável.

   cd /var/www/html
   sudo wget https://github.com/openemr/openemr/archive/refs/tags/v7_0_0.tar.gz
   sudo tar -xzvf v7_0_0.tar.gz
   sudo mv openemr-7_0_0 openemr
   sudo chown -R www-data:www-data openemr
   sudo chmod -R 755 openemrCopiar

   O que você deve ver: Diretório /var/www/html/openemr criado e com permissões corretas.

7. Configurar Apache para servir o OpenEMR

   É preciso criar um VirtualHost para isolar o OpenEMR e facilitar futuras integrações.

   sudo tee /etc/apache2/sites-available/openemr.conf > /dev/null <<EOF
   <VirtualHost *:80>
       DocumentRoot /var/www/html/openemr
       <Directory /var/www/html/openemr>
           AllowOverride All
           Require all granted
       </Directory>
       ErrorLog \/var\/log\/apache2\/openemr_error.log
       CustomLog \/var\/log\/apache2\/openemr_access.log combined
   </VirtualHost>
   EOF
   sudo a2ensite openemr.conf
   sudo a2enmod rewrite
   sudo systemctl reload apache2Copiar

   O que você deve ver: Site habilitado. Apache recarregado sem erros.

8. Instalar o OpenEMR via navegador

   A instalação web finaliza a configuração, conecta ao banco e gera arquivos críticos.

   Acesse http://192.168.56.10/openemr/setup.php pelo navegador. Siga o assistente, informando:
   - Database Name: openemr
   - Login Name: openemruser
   - Password: senha_forte
   - Host: localhostCopiar

   O que você deve ver: Assistente conclui sem erros. Tela de login do OpenEMR aparece.

9. Ajustar permissões pós-instalação

   Remova permissões de escrita desnecessárias para reduzir riscos.

   sudo chmod 640 /var/www/html/openemr/sites/default/sqlconf.phpCopiar

   O que você deve ver: Arquivo sqlconf.php protegido contra escrita indevida.

10. Configurar idioma para português

    Facilita o uso clínico no Brasil. O OpenEMR suporta múltiplos idiomas.

    No OpenEMR, acesse: Admin > Configurações Globais > Idioma > Portuguese (Brazilian)Copiar

    O que você deve ver: Interface do OpenEMR em português.

11. Testar login e navegação básica

    Confirme que o ambiente está funcional antes de pensar em integrações.

    Entre com o usuário admin definido na instalação.Copiar

    O que você deve ver: Acesso ao dashboard do OpenEMR sem erros.

Como saber que funcionou

Troubleshooting

Segurança e hardening

• Use senhas fortes para o banco e admin
• Restrinja acesso remoto ao MySQL (bind-address = 127.0.0.1)
• Proteja arquivos de configuração com permissões restritivas
• Remova arquivos de instalação após uso
• Mantenha sistema e dependências atualizados

Checklist final

• Sistema operacional atualizado
• Apache e MySQL ativos
• Banco de dados e usuário OpenEMR criados
• OpenEMR acessível via navegador
• Login e dashboard funcionais
• Permissões ajustadas no sqlconf.php
• Interface em português