MirrorNest
← All guides

ERPNext

ERPNext is a full open-source ERP built on the Frappe framework, covering accounting, manufacturing, CRM and more; the officially supported way to run it in production is via the frappe_docker Docker Compose setup.

Target: Any Docker hostBusinessERPOfficial homepage ↗Official docs ↗
This guide is synthesized from ERPNext's own official documentation, linked above — always cross-check exact package/version names there before running these commands on a production server, since distro and project versions move over time.

  1. 1Install Docker and Docker Compose

    curl -fsSL https://get.docker.com | bash
    DOCKER_CONFIG=${DOCKER_CONFIG:-$HOME/.docker}
    mkdir -p $DOCKER_CONFIG/cli-plugins
    curl -SL https://github.com/docker/compose/releases/download/v2.2.3/docker-compose-linux-x86_64 -o $DOCKER_CONFIG/cli-plugins/docker-compose
    chmod +x $DOCKER_CONFIG/cli-plugins/docker-compose

  2. 2Clone the official frappe_docker repository

    git clone https://github.com/frappe/frappe_docker
    cd frappe_docker

  3. 3Configure and deploy the stack

    Follow the single-server example to generate the compose YAML with environment files for Traefik, MariaDB and the ERPNext app, then bring the stack up.

    docker compose --project-name erpnext-one -f ~/gitops/erpnext-one.yaml up -d

  4. 4Create the first site

    Once the containers are healthy, create the site and install the erpnext app into it.

    docker compose --project-name erpnext-one exec backend bench new-site --mariadb-user-host-login-scope=% --db-root-password changeit --install-app erpnext --admin-password changeit one.example.com

    Replace changeit and one.example.com with your real password and domain before running this in production.