OrangeHRM na VPS: sistema de RH no seu servidor
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

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:
- Welcome e License: instalação nova e aceite da GPL;
- Database Configuration: dados do banco;
- System Check: vermelho bloqueia até corrigir e clicar em Re-Check;
- Instance Creation: dados da empresa;
- Admin User Creation: o administrador;
- 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.