Frappe ERPNext bench installation for Development for ubuntu 20.04 LTS (ARM64) & (Intel or AMD64)

Frappe/ERPNext bench installation for Development for ubuntu 20.04 LTS (ARM64)

Here are the instructions to set up the equivalent environment in an Ubuntu 22.04 ARM64 system. You can install these packages and set up the tools manually by following the given steps:

Prerequisites

Before starting, make sure to have a user with sudo privileges and an active internet connection.

Update System Packages

sudo apt-get update

Install Required Packages

sudo DEBIAN_FRONTEND=noninteractive apt-get install --no-install-recommends -y \
    git \
    mariadb-client \
    postgresql-client \
    gettext-base \
    wget \
    libssl-dev \
    fonts-cantarell \
    xfonts-75dpi \
    xfonts-base \
    libpango-1.0-0 \
    libjpeg62-turbo \
    libharfbuzz0b \
    libpangoft2-1.0-0 \
    libpangocairo-1.0-0 \
    locales \
    build-essential \
    cron \
    curl \
    vim \
    sudo \
    iputils-ping \
    watch \
    tree \
    nano \
    less \
    software-properties-common \
    bash-completion \
    libpq-dev \
    libffi-dev \
    liblcms2-dev \
    libldap2-dev \
    libmariadb-dev \
    libsasl2-dev \
    libtiff5-dev \
    libwebp-dev \
    redis-tools \
    rlwrap \
    tk8.6-dev \
    ssh-client \
    net-tools \
    make \
    libbz2-dev \
    libsqlite3-dev \
    zlib1g-dev \
    libreadline-dev \
    llvm \
    libncurses5-dev \
    libncursesw5-dev \
    xz-utils \
    tk-dev \
    liblzma-dev

Note: Kindly ignore if package does not install libjpeg62-turbo if you are trying it on Intel/AMD64 arch.

Set Locale

sudo sed -i -e 's/# en_US.UTF-8 UTF-8/en_US.UTF-8 UTF-8/' /etc/locale.gen
sudo dpkg-reconfigure --frontend=noninteractive locales

Install wkhtmltopdf

export WKHTMLTOPDF_VERSION=0.12.6-1
export ARCH=arm64
downloaded_file=wkhtmltox_$WKHTMLTOPDF_VERSION.buster_${ARCH}.deb
wget -q https://github.com/wkhtmltopdf/packaging/releases/download/$WKHTMLTOPDF_VERSION/$downloaded_file
sudo dpkg -i $downloaded_file
rm $downloaded_file

Create New User

sudo adduser -ms /bin/bash frappe
sudo groupadd -g 1000 frappe
sudo useradd --no-log-init -r -m -u 1000 -g 1000 -G sudo frappe
echo "frappe ALL=(ALL) NOPASSWD: ALL" | sudo tee -a /etc/sudoers

Switch to the New User

su - frappe

Install Python 3.9.9 & 3.10.5 for version 13 & 14 via pyenv

export PYTHON_VERSION_V13=3.9.9
export PYTHON_VERSION=3.10.5
git clone --depth 1 https://github.com/pyenv/pyenv.git ~/.pyenv
export PYENV_ROOT=~/.pyenv
export PATH=$PYENV_ROOT/shims:$PYENV_ROOT/bin:$PATH
pyenv install $PYTHON_VERSION_V13
pyenv install $PYTHON_VERSION
PYENV_VERSION=$PYTHON_VERSION_V13 pip install --no-cache-dir virtualenv
PYENV_VERSION=$PYTHON_VERSION pip install --no-cache-dir virtualenv
pyenv global $PYTHON_VERSION $PYTHON_VERSION_v13
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.profile
echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.profile
echo 'eval "$(pyenv init --path)"' >> ~/.profile
echo 'eval "$(pyenv init -)"' >> ~/.bashrc

Clone and Install Bench

export PATH=$HOME/.local/bin:$PATH
export GIT_REPO=https://github.com/frappe/bench.git
export GIT_BRANCH=v5.x
git clone ${GIT_REPO} --depth 1 -b ${GIT_BRANCH} ~/.bench
pip install --no-cache-dir --user -e .bench
echo "export PATH=$HOME/.local/bin:\$PATH" >> ~/.bashrc
echo "export BENCH_DEVELOPER=1" >> ~/.bashrc

Install Node.js via NVM

export NODE_VERSION_14=14.19.3
export NODE_VERSION=16.18.0
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
export NVM_DIR=~/.nvm
source ${NVM_DIR}/nvm.sh
nvm install ${NODE_VERSION_14}
nvm use v${NODE_VERSION_14}
npm install -g yarn
nvm install ${NODE_VERSION}
nvm use v${NODE_VERSION}
npm install -g yarn
nvm alias default v${NODE_VERSION}
rm -rf ${NVM_DIR}/.cache
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bashrc
echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm' >> ~/.bashrc
echo '[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion' >> ~/.bashrc

Verify the Setup

At this point, all the necessary tools should be installed. Verify this by checking the installed versions.

node --version
npm --version
yarn --version
bench --help

Install MariaDB/MySQL

sudo apt install mariadb-server
sudo mysql_secure_installation

Initially, there is no password for root. Press ENTER.

Enter current password for root (enter for none):

Press ENTER to enter a new password.

Set root password? [Y/n]

Enter and confirm a root password for MariaDB.

New password:

Re-enter new password:

Password updated successfully!

Press ENTER to remove the anonymous user.

Remove anonymous users? [Y/n]

Press ENTER to disallow remote root logins.

Disallow root login remotely? [Y/n]

Press ENTER to remove the test database.

Remove test database and access to it? [Y/n]

Press ENTER to reload the privilege tables.

Reload privilege tables now? [Y/n]

This completes the basic security configuration.

MySQL Config

sudo nano /etc/mysql/conf.d/frappe.cnf

Add following config to frappe.cnf then save file and exit nano editor:

[mysqld]
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci

[mysql]
default-character-set = utf8mb4

Restart Msariadb server to apply new configuration

sudo systemctl restart mysqld.service

Install Redis Server

sudo apt install redis-server
echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p

Initialize Frappe bench with ERPNext v14

 bench init frappe-bench --frappe-branch version-14 --install-app erpnext

Create first Site

bench new-site site1.local --install-app erpnext
# OR
# You can install addional apps using following commands
# bench get-app branch version-14 erpnext https://github.com/frappe/erpnext
# bench --site site1.local install-app erpnext

Start bench Development server

cd frappe-bench
bench start

You should now have a working Ubuntu 22.04 arm64 environment set up. Enjoy developing with Frappé!

Direct Download Links for downloading Ubuntu 20.04 LTS 64bit ARM Editions

Direct Download Links for downloading Ubuntu 20.04 LTS 64bit Editions

Desktop and Server Edition (Without Desktop)

ubuntu-20.04.6-desktop-amd64.iso                   16-Mar-2023 15:58
ubuntu-20.04.6-live-server-amd64.iso               14-Mar-2023 23:02

Other mirrors (choose mirrors based on your country/location for faster download):

Frappe/ERPNext bench installation for Development for ubuntu 20.04 LTS (Intel/AMD64)

Install wkhtmltopdf for Intel/AMD64

Please note: The following adjustment is specifically necessary for those utilizing Intel/AMD64 architecture to ensure a successful installation. All other steps in the process will remain unchanged.

export WKHTMLTOPDF_VERSION=0.12.6-1
export ARCH=amd64
downloaded_file=wkhtmltox_$WKHTMLTOPDF_VERSION.buster_${ARCH}.deb
wget -q https://github.com/wkhtmltopdf/packaging/releases/download/$WKHTMLTOPDF_VERSION/$downloaded_file
sudo dpkg -i $downloaded_file
rm $downloaded_file
1 Like

Permalink:

Tested on VMWare Phusion VM, KVM VM, Hyper-V VM, VirtualBox VM and Ubuntu ISO used to perform installation is located at bottom · GitHub

have you tried installing on Debian 11? I keep getting ModuleNotFoundError: No module named ‘apt_pkg’ and python3-apt must be installed and made available to /usr/local/bin/python3.10

I haven’t as of yet but I will surely give a try and post my findings soon.

Debian 11 (Bullseye) comes with Python 3.9 by default, not Python 3.10. are you using pyenv or virtualenv?

Neither. I am following the standard install process after upgrading Python to 3.10.

UPDATE: I decided to run the installation inside python3.10 venv and it worked!

1 Like