ERPNext Docker deployment on EasyPanel - Container connectivity issues

ERPNext
, ,
1

Hello Frappe Community,

I’m a software studio founder working with 3D animations and VR/AR experiences, and I’m trying to deploy ERPNext on a Hostinger VPS using EasyPanel as the control panel. After extensive troubleshooting over two days, I’ve hit several roadblocks and would greatly appreciate guidance from the community.

Environment:

  • Host: Hostinger VPS (Ubuntu-based)

  • Control Panel: EasyPanel (Docker-based)

  • Goal: Install and run ERPNext production-ready on the VPS via EasyPanel

Attempts Made:

Attempt 1: Docker Compose with Manual Service Definition

  • Created separate services for MariaDB and Redis via EasyPanel templates :white_check_mark:

  • Both services started successfully (green status)

  • Created Docker Compose file with backend, frontend, websocket, queue-short, queue-long, and scheduler services

  • Issue: Container networking error - “Could not attach to network adm: network adm not found”

  • Root Cause: EasyPanel doesn’t automatically recognize external services in Compose

Attempt 2: Docker Compose with Network Configuration

  • Modified Compose to reference MariaDB/Redis by container name

  • Issue: Port 80 conflict (other services using it)

  • Changed to port 8080 - deployment seemed successful but service remained unresponsive

Attempt 3: JSON Schema Approach (Most Promising)

  • Used EasyPanel’s “Create from Schema” feature to define three separate services

  • :white_check_mark: All three services deployed successfully (green status)

  • :white_check_mark: Created site via console: bench new-site erpnext.local --db-type mariadb --db-host erpnext-db --db-user root --db-password [PASSWORD]

  • Site confirmed created: “Site erpnext.local already exists”

  • Issue: Browser cannot reach http://VPS_IP:8080 - “ERR_CONNECTION_REFUSED”

  • Root Cause: The frappe/erpnext:latest Docker image is minimal and doesn’t auto-start web services

Key Problems Identified:

  1. Image Limitation: The standard frappe/erpnext:latest Docker image requires manual initialization and doesn’t automatically start Nginx/web services

  2. EasyPanel Compatibility: While EasyPanel can deploy the containers, there’s a gap between deployment and a functioning ERPNext instance

  3. Documentation Gap: No clear, step-by-step guide for ERPNext installation via EasyPanel with separate database services

What I Need:

  1. Official Docker image recommendation for production use with EasyPanel

  2. Complete Dockerfile or Compose example that works out-of-the-box on EasyPanel

  3. Initialization scripts that auto-create the site and start services

  4. Configuration details for proper container networking on EasyPanel

My objective is to have ERPNext running on a Hostinger VPS managed via EasyPanel, with proper MariaDB and Redis separation, so our studio can use it for project tracking and team collaboration.

Thank you for any guidance!

Best regards,
Henrique Marques
Neopixel Digital