How do I self-host OrangeHRM?

OrangeHRM can be deployed using Docker Compose. The AltStack provides a production-ready configuration that you can deploy on your own server. Simply copy the configuration and run it on any machine with Docker installed.

Is OrangeHRM free to self-host?

Yes, OrangeHRM is open source under the GPL-3.0 and free to self-host. Your only costs are the server infrastructure. A basic cloud VPS starts at around $5-10/month.

What programming language is OrangeHRM built with?

OrangeHRM is built with PHP. It has 1,151 stars on GitHub, indicating strong community adoption and support.

Back to Self-Hosted Stacks

Deploy OrangeHRM

The world's most popular open source human resource management software.

Quick Start

Create a directory

mkdir orangehrm-self-hosted && cd orangehrm-self-hosted

Create config file

Copy the content from the Config tab below into a file named docker-compose.yml

Deploy

docker compose up -d

Fast Track

Deploy OrangeHRM in Minutes

Use our optimized Docker templates to deploy OrangeHRM on any cloud provider. Get $200 in free credit to start on DigitalOcean.

Start with free creditDeploy on DigitalOcean

$200

Metadata

License

GPL-3.0

Language

PHP

Last Updated

6/28/2026

Configuration

yaml

services:
  orangehrm:
    image: orangehrm/orangehrm:latest
    container_name: orangehrm
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy
    ports:
      - "8080:80"
    environment:
      - ORANGEHRM_DATABASE_HOST=db
      - ORANGEHRM_DATABASE_USER=orangehrm
      - ORANGEHRM_DATABASE_PASSWORD=orangehrm
      - ORANGEHRM_DATABASE_NAME=orangehrm
    volumes:
      - orangehrm_data:/var/www/html

  db:
    image: mariadb:10.11
    container_name: orangehrm-db
    restart: unless-stopped
    environment:
      - MARIADB_ROOT_PASSWORD=rootpass
      - MARIADB_USER=orangehrm
      - MARIADB_PASSWORD=orangehrm
      - MARIADB_DATABASE=orangehrm
    volumes:
      - orangehrm_db_data:/var/lib/mysql
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  orangehrm_data:
  orangehrm_db_data:

Community Notes

Help others by adding context, corrections, or warnings about this tool. Sign in to contribute.

No community notes yet. Be the first to add context.