Deploying ERPNext on Easypanel — a Step-by-Step Guide

ERPNext is a powerful, open-source ERP built on the Frappe framework. Easypanel, on the other hand, is a sleek, developer-friendly PaaS you host yourself. Put them together and you get a hassle-free, one-click way to host ERPNext without fighting YAML files on the command line.

Deploying ERPNext on Easypanel — a Step-by-Step Guide

In this tutorial we’ll:

  1. Add a Compose Service in Easypanel that points to a public Git repo
  2. Let Easypanel build & start the multi-container stack (MariaDB, Redis, backend, frontend, scheduler, workers)
  3. Map our domain to the frontend container on port 8080
  4. Log in with the default Administrator / admin credentials
Repo we’re using
Source section of Compose Service

1 Create a new Compose Service in Easypanel

  1. Log in to your Easypanel dashboard.
  2. Click > Compose Service.
  3. Fill the Git details in Source Section:

Git Repositoryhttps://github.com/Ahson-Shaikh/easypanel-erpnext
Branchmain
Root Path/
Compose Filedocker-compose.yml

⏱ Build time: first run takes 5–7 min depending on your bandwidth. Subsequent deploys are much faster thanks to Docker cache.

You can watch live logs under Deployments → Overview. When it flips to Running, all containers are up.

2 Expose the frontend on your domain

  1. Go to Domains in the left sidebar.
  2. Click the domain (or add a new one).
  3. Change Service to the one you just created.
  4. Port → 8080 (the frontend container listens there).
  5. Open the domain.
  6. If even after 5–7 minutes, ErpNext is not opening up, hit deploy again and then open after 30s-60s.

3 First login to ERPNext

Open https://<your-domain> in the browser. You should see the familiar ERPNext login screen.

  • User: Administrator
  • Password: admin
✅ Tip: The first login triggers ERPNext’s setup wizard. Fill in company name, fiscal year, default currency, etc.

Read more