Sürüm 16 yı Ubuntu 26 ya mı kurmak istiyorsun?

Yeni sürümlerin getirdiği uyumluluk ve işlevlerden yararlanmak için özellikle de sisteminizi yeni kurmaktaysanız en son geçerli sürümle hareket etmek yerinde olacaktır.

Deneyimlerimizden kaynaklı aşamaları Gemini ile topladık ve bir "script" haline getirdik. Ubuntu 26LTS'de artık ERPNext sürüm 16 kurabilirsiniz.

#!/bin/bash

set -e # Exit immediately if a command exits with a non-zero status

echo "============================================================"

echo " Starting fail-safe ERPNext v16 installation for Ubuntu 26"

echo "============================================================"

# 1. Update system and install all core dependencies, compilers, and headers

echo ">>> Installing core tools, compilers, and database headers..."

sudo apt update && sudo apt upgrade -y

sudo apt install -y curl git libffi-dev libssl-dev redis-server xvfb libfontconfig1 \

    mariadb-server mariadb-client pkg-config build-essential libmariadb-dev libmariadb-dev-compat

# 2. Install wkhtmltopdf manually (bypassing Ubuntu 26 repo limitations)

echo ">>> Installing wkhtmltopdf..."

wget -q https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-2/wkhtmltox_0.12.6.1-2.jammy_amd64.deb

sudo apt install -y ./wkhtmltox_0.12.6.1-2.jammy_amd64.deb

rm wkhtmltox_0.12.6.1-2.jammy_amd64.deb

# 3. Configure MariaDB for Frappe

echo ">>> Configuring MariaDB encoding..."

sudo bash -c 'cat <<EOF >> /etc/mysql/mariadb.conf.d/50-server.cnf

[mysqld]

character-set-client-handshake = FALSE

character-set-server = utf8mb4

collation-server = utf8mb4_unicode_ci

[mysql]

default-character-set = utf8mb4

EOF'

# Restart MariaDB and configure standard password auth (fixes the unix_socket issue)

echo ">>> Securing MariaDB and setting root password to 'admin'..."

sudo systemctl restart mariadb

sudo mysql -u root -e "ALTER USER 'root'@'localhost' IDENTIFIED BY 'admin';"

sudo mysql -u root -e "GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' WITH GRANT OPTION;"

sudo mysql -u root -e "FLUSH PRIVILEGES;"

# 4. Install Node.js 24 and Yarn

echo ">>> Installing Node 24 and Yarn..."

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -

sudo apt install -y nodejs

sudo npm install -g yarn

# 5. Install Python 3.14, pipx, and uv (fixes the 'uv not found' error)

echo ">>> Installing Python 3.14, pipx, and uv..."

sudo apt install -y python3.14 python3.14-venv python3.14-dev pipx

pipx ensurepath

curl -LsSf https://astral.sh/uv/install.sh | sh

export PATH="$HOME/.local/bin:$HOME/.cargo/bin:$PATH"

# 6. Install Frappe Bench CLI

echo ">>> Installing Frappe Bench..."

pipx install frappe-bench --python python3.14

export PATH="$HOME/.local/bin:$PATH"

# 7. Initialize the workspace (The C-headers and gcc are now present for mysqlclient)

echo ">>> Initializing the Frappe Bench (this will take a few minutes)..."

bench init frappe-bench --frappe-branch version-16 --python python3.14

cd frappe-bench

# 8. Create the site and install ERPNext

echo ">>> Creating dev.local site and installing ERPNext..."

bench new-site dev.local --db-root-password admin --admin-password admin

bench get-app --branch version-16 erpnext

bench --site dev.local install-app erpnext

bench --site dev.local enable-scheduler

# 9. Map the local domain

echo ">>> Mapping dev.local to hosts file..."

sudo sed -i '1s/^/127.0.0.1\tdev.local\n/' /etc/hosts

echo "============================================================"

echo " SUCCESS! Your ERPNext v16 environment is ready."

echo " MariaDB Root Password: admin"

echo " ERPNext Administrator Password: admin"

echo "============================================================"

echo " To start developing:"

echo " 1. Type: cd ~/frappe-bench"

echo " 2. Type: bench start"

echo " 3. Open your browser to http://dev.local:8000"