Base de Conhecimento

OrangeHRM na VPS: sistema de RH no seu servidor

  • orangehrm, sistema de rh, docker, vps, lgpd
  • Usuários acharam útil: 0

OrangeHRM 5.9: edição Starter grátis sob GPL-3.0, aviso sobre a linha 4.x, instalação com Docker Compose, Nginx e HTTPS, backup, atualização e dados de funcionários.

Por Redação Eleven Host · @robson.direitodigital · 13 de novembro de 2026 · 10 min de leitura

Arte da Eleven Host: janela de terminal com o título: OrangeHRM na VPS: sistema de RH no seu servidor

Capa da Redação Eleven Host para o guia: OrangeHRM na VPS: sistema de RH no seu servidor Arte: Eleven Host

OrangeHRM na VPS é um sistema de RH de código aberto instalado num servidor seu, para cadastro de funcionários, férias, controle de tempo e recrutamento. Veja a licença, a versão 5.9, os requisitos, a instalação com Docker, o HTTPS, o backup e a atualização.

Atualizado em 13/11/2026. Os blocos de exemplo não foram executados: confira cada um no seu servidor. O artigo O que é servidor VPS: guia simples para iniciantes explica o que é uma VPS.

O que é o OrangeHRM

O OrangeHRM é um sistema de gestão de recursos humanos (HRM) completo, que reúne as funções essenciais de RH de uma empresa. A edição gratuita e de código aberto é a OrangeHRM Starter. Segundo a página do fabricante, ela cobre cadastro de funcionários, férias e ausências, controle de tempo, recrutamento, avaliações de desempenho, relatórios e app de celular.

Existe também uma edição paga, a OrangeHRM Advanced, com teste grátis de 30 dias e módulos extras, como Roster, Surveys, Employee Voice e Discipline. O suporte do Starter é pela comunidade.

O Starter é gratuito, sob a licença GPL-3.0. Em 13/11/2026, a versão estável é a 5.9, de 28/06/2026. Use a 5.9 e não a linha 4.x, que chegou ao fim de vida, tem falha crítica sem correção e ainda aparece como tag no Docker Hub.

Licença e versão

O arquivo de licença do repositório é o texto padrão da GNU GPL versão 3, sem termos adicionais.

A 5.9 saiu em 28/06/2026. Antes dela vieram a 5.8.1 (06/04/2026) e a 5.8.0 (21/11/2025). A 5.9 traz melhorias de segurança.

Não use a linha 4.x

O projeto informa que a linha 4.x está em fim de vida e não será corrigida. Há nela uma falha crítica, de execução remota de código sem login, que o aviso de segurança do projeto diz já ter sido explorada na prática. O aviso recomenda usar uma versão 5.x com suporte. O Docker Hub ainda lista a tag 4.10.1 ao lado da 5.9: não use essa tag.

A linha 5.x também teve avisos, corrigidos depois. O GHSA-2w7w-h5wv-xr55, crítico, tratava de execução de código pelo parâmetro do sendmail na configuração de e-mail e foi corrigido na 5.8. Recomendamos acompanhar as páginas de versões e de avisos de segurança do repositório github.com/orangehrm/orangehrm e atualizar quando sair uma correção.

Requisitos oficiais

Para a 5.9, a página da versão lista PHP de 7.4 a 8.5, MariaDB de 5.5 a 12.0 e MySQL de 5.5 a 9.4. A imagem Docker oficial usa PHP 8.3 com Apache e já traz extensões de PHP como gd, intl e pdo_mysql, por isso o PHP não é instalado no servidor. O Nginx entra só como proxy: o app roda no Apache da imagem.

Os comandos abaixo usam Ubuntu; a documentação do Docker lista o 22.04, o 24.04 e o 26.04 (LTS).

Esta instalação começa por um servidor. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Docker pelo repositório oficial

Primeiro o Docker Engine, instalado pelo repositório da documentação do Docker, antes do apt install dos pacotes. Um exemplo de comandos, a partir da documentação do Docker para Ubuntu:

sudo apt update

sudo apt install ca-certificates curl

sudo install -m 0755 -d /etc/apt/keyrings

sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc

sudo chmod a+r /etc/apt/keyrings/docker.asc

sudo tee /etc/apt/sources.list.d/docker.sources <<EOF

Types: deb

URIs: https://download.docker.com/linux/ubuntu

Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")

Components: stable

Architectures: $(dpkg --print-architecture)

Signed-By: /etc/apt/keyrings/docker.asc

EOF

sudo apt update

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

sudo docker run hello-world

Pasta, senhas e compose

Um exemplo de comandos para criar a pasta e o arquivo de senhas:

mkdir -p ~/orangehrm

cd ~/orangehrm

touch .env

chmod 600 .env

nano .env

No .env, defina as senhas (valores de exemplo: troque os dois):

DB_ROOT_PASSWORD=troque-esta-senha-1

DB_PASSWORD=troque-esta-senha-2

A OrangeHRM não publica um compose oficial, e a página dela sobre Docker é de 2020, com MariaDB 10.4 e sem volumes. Um exemplo de docker-compose.yml, na pasta ~/orangehrm, montado pela Eleven Host e não oficial:

services:

db:

image: mariadb:11.8

environment:

MARIADB_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}

MARIADB_DATABASE: orangehrm

MARIADB_USER: orangehrm

MARIADB_PASSWORD: ${DB_PASSWORD}

volumes:

- db_data:/var/lib/mysql

restart: unless-stopped

orangehrm:

image: orangehrm/orangehrm:5.9

ports:

- "127.0.0.1:8080:80"

volumes:

- ohrm_html:/var/www/html

depends_on:

- db

restart: unless-stopped

volumes:

db_data:

ohrm_html:

A tag 5.9 fica fixa em vez de latest, para a versão só mudar quando você decidir. O MariaDB 11.8 está dentro da faixa até 12.0 da 5.9; em 13/11/2026, as tags latest e lts do MariaDB apontam para versões acima de 12.0. O volume ohrm_html guarda o código e a pasta lib/confs, com a configuração.

Porta presa ao 127.0.0.1

A documentação do Docker avisa que portas publicadas pelo Docker passam por cima das regras do firewall, como as do ufw. Sem o 127.0.0.1, a 8080 ficaria aberta em HTTP para a internet, e quem chegasse primeiro ao instalador poderia criar o administrador do sistema.

Suba os serviços e confira o estado:

sudo docker compose up -d

sudo docker compose ps

Firewall, Nginx e HTTPS

Um exemplo de comandos que liberam SSH, HTTP e HTTPS no ufw. A 22 vai antes do enable:

sudo ufw allow 22/tcp

sudo ufw allow 80/tcp

sudo ufw allow 443/tcp

sudo ufw enable

Aponte um subdomínio, como rh.exemplo.com.br, para o IP da VPS antes de pedir o certificado.

No Nginx, o limite padrão de upload é 1 MB, e acima dele o erro é o 413. Por isso o exemplo sobe para 10M. A imagem não altera upload_max_filesize nem post_max_size: se anexos maiores falharem, confira também os limites do PHP.

sudo apt install nginx

sudo nano /etc/nginx/sites-available/rh.exemplo.com.br

server {

listen 80;

server_name rh.exemplo.com.br;

client_max_body_size 10M;

location / {

proxy_pass http://127.0.0.1:8080;

proxy_set_header Host $host;

proxy_set_header X-Forwarded-Proto $scheme;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

}

}

Depois, um exemplo para ativar o bloco, testar a sintaxe e recarregar o Nginx, seguido dos comandos do Certbot, pelo snap, conforme as instruções dele para Nginx:

sudo ln -s /etc/nginx/sites-available/rh.exemplo.com.br /etc/nginx/sites-enabled/

sudo nginx -t

sudo systemctl reload nginx

sudo snap install --classic certbot

sudo ln -s /snap/bin/certbot /usr/local/bin/certbot

sudo certbot --nginx -d rh.exemplo.com.br

sudo certbot renew --dry-run

Quem chega primeiro cria o admin

Entre o bloco do Nginx e o certificado, o endereço responde em HTTP. Faça as duas etapas em seguida e só abra o instalador depois do HTTPS: é nele que o administrador é criado, e quem chegar primeiro à tela cria o dele.

A OrangeHRM não tem passo a passo oficial para proxy reverso com HTTPS. Teste o acesso por HTTPS antes de cadastrar dados: confira se a tela de login, os links e os redirecionamentos continuam em https.

Instalador web

Abra https://rh.exemplo.com.br no navegador. O instalador segue estas telas, conforme o guia oficial:

  1. Welcome e License: instalação nova e aceite da GPL;
  2. Database Configuration: dados do banco;
  3. System Check: vermelho bloqueia até corrigir e clicar em Re-Check;
  4. Instance Creation: dados da empresa;
  5. Admin User Creation: o administrador;
  6. Confirmation e Installation, até Launch OrangeHRM.

Um exemplo de preenchimento do banco: servidor db, porta 3306, banco orangehrm, usuário orangehrm e a senha do .env. A tela pode pedir uma conta com privilégio para criar o banco: confira na tela. Se der erro, o guia oficial indica o Clean Up Install, ou apagar o banco, ou usar outro nome, antes de tentar de novo.

Outros sistemas internos

Outras áreas da empresa também têm artigo na base de conhecimento: Snipe-IT na VPS: inventário de TI no seu servidor, Akaunting na VPS: financeiro da empresa no seu servidor e OpenProject na VPS: gestão de projetos da equipe.

Backup e atualização

A OrangeHRM não documenta atualização em Docker. Antes de atualizar, copie o banco e o volume do código. Um exemplo de comando para o banco, rodado na pasta do projeto:

sudo docker compose exec -T db sh -c 'mariadb-dump --single-transaction -u root -p"$MARIADB_ROOT_PASSWORD" orangehrm' > orangehrm-AAAA-MM-DD.sql

E um exemplo para o volume do app, que inclui a pasta lib/confs, onde fica a chave, se você ativou a criptografia. O nome do volume começa pelo nome da pasta do projeto: confira com sudo docker volume ls.

sudo docker run --rm -v orangehrm_ohrm_html:/dados:ro -v "$PWD":/backup busybox tar czf /backup/ohrm-html.tgz -C /dados .

Trocar a tag no compose não atualiza o app: o código mora no volume, e o Docker só copia o conteúdo da imagem para um volume novo e vazio. O guia oficial de atualização da série 5 orienta usar o upgrader sobre uma cópia do banco, porque o banco original pode ficar irrecuperável se der erro. Um caminho possível no Docker, não testado: volume novo para o código da nova tag e upgrader apontado para a cópia. Recomendamos ensaiar num servidor de teste.

Tarefas agendadas e e-mail

O OrangeHRM tem o comando orangehrm:run-schedule, que executa o agendador. A imagem não instala cron: o agendamento e a frequência ficam por sua conta. Se for usá-lo, teste.

Há uma tela de configuração de e-mail, com teste de envio, desde a versão 2.2. Não há artigo oficial do Starter sobre SMTP, então confira o menu na própria tela. Recomendamos SMTP com autenticação, já que a falha crítica citada acima estava no envio por sendmail.

Dados de funcionários e LGPD

O sistema guarda dados pessoais da equipe e de candidatos, e a LGPD trata dessas informações. Recomendamos limitar quem tem conta de administrador, manter o HTTPS e as atualizações em dia e proteger também as cópias de backup, que contêm esses dados. O histórico de alterações do OrangeHRM registra, desde a 4.2, um módulo de manutenção para expurgar registros de funcionários e de candidatos; confira na sua instalação se ele está disponível e como acessá-lo. Cumprir a LGPD depende dos processos da empresa e cabe ao jurídico avaliar.

O endereço do sistema de RH

Os exemplos usam rh.exemplo.com.br, um subdomínio que parte de um domínio registrado.

Para escolher o nome, a Eleven Host tem centenas de extensões. Buscar domínio

Perguntas frequentes

O OrangeHRM é gratuito?

A edição Starter é gratuita e de código aberto, sob a GPL-3.0, com suporte pela comunidade. A edição Advanced é paga, tem teste grátis de 30 dias, e o preço é definido pelo fabricante.

Qual versão do OrangeHRM usar?

A 5.9, de 28/06/2026, que era a versão estável em 13/11/2026. A linha 4.x está em fim de vida e tem falha crítica sem correção.

Instalar o OrangeHRM resolve a LGPD?

A adequação à LGPD depende dos processos da empresa, e não apenas do sistema escolhido. Recomendamos que o jurídico avalie o uso dos dados da equipe.

Esta resposta lhe foi útil?

Artigos Relacionados