How to Install ERPNext on ARM64 (Apple Silicon & Ampere) Using Docker

ARM64 architecture (aarch64) is widely used across modern infrastructure, from developer laptops powered by Apple Silicon (M1, M2, M3, M4) to cloud servers like Oracle Cloud Ampere A1 and AWS Graviton.

Historically, installing ERPNext on ARM64 chips was frustrating: binary Python wheel incompatibilities, node compilation failures, and MariaDB architecture mismatch errors.

Fortunately, with official multi-arch Docker images, running ERPNext natively on ARM64 is now smooth and blazing fast without emulation overhead. Here is the full guide.

---

Why Native ARM64 Beats x86 Emulation (Rosetta)

Running x86 Docker images through Rosetta or QEMU translation causes:

• 40% to 60% slower bench command execution.
• High CPU usage and battery drain.
• Random segfaults during Node/wkhtmltopdf compilation.

Running native linux/arm64 images delivers 100% native CPU performance and instant container startup times.

---

Prerequisites

1. Docker Desktop (on macOS) or Docker Engine + Docker Compose v2 (on Linux ARM64).
2. Minimum 4 GB RAM allocated to Docker (8 GB recommended for ERPNext).
3. Git installed.

---

Step 1: Clone the frappe_docker Repository

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

---

Step 2: Configure the Environment File

Copy the sample environment file:

cp example.env .env

Open .env and verify key parameters:

FRAPPE_VERSION=version-15
ERPNEXT_VERSION=version-15
DB_PASSWORD=your_secure_mariadb_password
ADMIN_PASSWORD=your_secure_admin_password
SITES=frontend.localhost

---

Step 3: Launch Native ARM64 Containers

Run the compose stack targeting the native ARM64 images:

docker compose -f compose.yaml \
  -f overrides/compose.mariadb.yaml \
  -f overrides/compose.redis.yaml \
  -f overrides/compose.noproxy.yaml \
  up -d

Verify that all containers are running native ARM architecture:

docker inspect --format '{{.Architecture}}' $(docker compose ps -q backend)
# Should return: arm64

---

Step 4: Create Your First ERPNext Tenant Site

Execute the site creation command inside the backend container:

docker compose exec backend bench new-site frontend.localhost \
  --db-root-password your_secure_mariadb_password \
  --admin-password your_secure_admin_password \
  --install-app erpnext

---

Step 5: Access ERPNext in Your Browser

Open your browser and navigate to:

http://localhost:8080

Log in with:

• Username: Administrator
• Password: your_secure_admin_password

Complete the initial Setup Wizard (select Company Name, Currency, Fiscal Year, and Charts of Accounts), and your fully native ARM64 ERPNext system is ready to use!

---

Summary

Native ARM64 Docker deployments provide the best price-to-performance ratio in cloud hosting today and offer a buttery-smooth local development experience on Apple Silicon.

Need custom ERPNext architecture, multi-tenant setups, or enterprise Frappe integrations? Connect with the full-stack ERP engineers at Klickspell.