{"id":14,"date":"2025-08-04T10:41:22","date_gmt":"2025-08-04T10:41:22","guid":{"rendered":"https:\/\/docs.inbizsys.com\/index.php\/docs\/erp\/installation\/"},"modified":"2025-08-04T10:50:05","modified_gmt":"2025-08-04T10:50:05","slug":"installation","status":"publish","type":"docs","link":"https:\/\/docs.inbizsys.com\/index.php\/docs\/erp\/installation\/","title":{"rendered":"Installation"},"content":{"rendered":"

\ud83d\udcdd Table of Contents<\/h2>\n
    \n
  1. \n

    System Requirements<\/a><\/p>\n<\/li>\n

  2. \n

    Pre-Installation<\/a><\/p>\n<\/li>\n

  3. \n

    Database Configuration<\/a><\/p>\n<\/li>\n

  4. \n

    Frappe & ERPNext Installation<\/a><\/p>\n<\/li>\n

  5. \n

    Production Deployment (NGINX & Supervisor)<\/a><\/p>\n<\/li>\n

  6. \n

    Post-Installation Setup<\/a><\/p>\n<\/li>\n

  7. \n

    Security Tips<\/a><\/p>\n<\/li>\n

  8. \n

    Troubleshooting<\/a><\/p>\n<\/li>\n<\/ol>\n

    \n

    \u2705 System Requirements<\/h2>\n
    \n
    \n\n\n\n\n\n\n\n\n\n
    Component<\/th>\nMinimum Requirement<\/th>\n<\/tr>\n<\/thead>\n
    OS<\/td>\nUbuntu 22.04 LTS (64-bit)<\/td>\n<\/tr>\n
    RAM<\/td>\n2 GB minimum (4 GB recommended)<\/td>\n<\/tr>\n
    CPU<\/td>\n1 vCPU minimum<\/td>\n<\/tr>\n
    Disk<\/td>\n20 GB+<\/td>\n<\/tr>\n
    Access<\/td>\nRoot or sudo user<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    \n
    <\/div>\n<\/div>\n<\/div>\n<\/div>\n
    \n

    \u2699\ufe0f Pre-Installation<\/h2>\n

    1. Update System<\/h3>\n
    \n
    sudo apt update && sudo apt upgrade -y<\/code><\/div>\n<\/div>\n

    2. Install Required Packages<\/h3>\n
    \n
    \n
    \n
    <\/div>\n<\/div>\n<\/div>\n
    sudo apt install -y git python3-dev python3-pip python3-venv \\
    \nbuild-essential libffi-dev libssl-dev libmysqlclient-dev libjpeg-dev \\
    \nzlib1g-dev libpq-dev curl wget nodejs npm
    \n<\/code><\/div>\n<\/div>\n

    3. Create System User<\/h3>\n
    \n
    \n
    \n
    <\/div>\n<\/div>\n<\/div>\n
    sudo adduser --system --home=\/opt\/erpnext --group erpnext
    \n<\/code><\/div>\n<\/div>\n
    \n

    \ud83d\udee2\ufe0f Database Configuration<\/h2>\n

    1. Install MariaDB<\/h3>\n
    \n
    \n
    \n
    <\/div>\n<\/div>\n<\/div>\n
    sudo apt install mariadb-server mariadb-client -y
    \nsudo mysql_secure_installation
    \n<\/code><\/div>\n<\/div>\n

    2. Create Database & User<\/h3>\n
    \n
    \n
    \n
    <\/div>\n<\/div>\n<\/div>\n
    sudo mysql -<\/span>u root -<\/span>p<\/p>\n

    CREATE<\/span> DATABASE erpnext_db;
    \nCREATE<\/span> USER<\/span> 'erpnext_user'<\/span>@'localhost'<\/span> IDENTIFIED BY<\/span> 'StrongPassword123'<\/span>;
    \nGRANT<\/span> ALL<\/span> PRIVILEGES ON<\/span> erpnext_db.*<\/span> TO<\/span> 'erpnext_user'<\/span>@'localhost'<\/span>;
    \nFLUSH PRIVILEGES;
    \nEXIT;
    \n<\/code><\/div>\n<\/div>\n

    \n

    \ud83e\uddf1 Frappe & ERPNext Installation<\/h2>\n

    1. Install Node.js & Yarn<\/h3>\n
    \n
    \n
    \n
    <\/div>\n<\/div>\n<\/div>\n
    sudo npm install -g yarn
    \n<\/code><\/div>\n<\/div>\n

    2. Install Redis Server<\/h3>\n
    \n
    \n
    \n
    <\/div>\n<\/div>\n<\/div>\n
    sudo apt install redis-server -y
    \n<\/code><\/div>\n<\/div>\n

    3. Install Frappe Bench CLI<\/h3>\n
    \n
    \n
    \n
    <\/div>\n<\/div>\n<\/div>\n
    sudo pip3 install frappe-bench
    \n<\/code><\/div>\n<\/div>\n

    4. Create New Bench & Site<\/h3>\n
    \n
    \n
    \n
    <\/div>\n<\/div>\n<\/div>\n
    bench init erpnext-bench --frappe-branch version-15
    \ncd<\/span> erpnext-bench
    \nbench new-site erp.mysite.local
    \n<\/code><\/div>\n<\/div>\n

    5. Get ERPNext App<\/h3>\n
    \n
    \n
    \n
    <\/div>\n<\/div>\n<\/div>\n
    bench get-app erpnext --branch version-15
    \nbench --site erp.mysite.local install-app erpnext
    \n<\/code><\/div>\n<\/div>\n

    6. Run Development Server<\/h3>\n
    \n
    \n
    \n
    <\/div>\n<\/div>\n<\/div>\n
    bench start
    \n<\/code><\/div>\n<\/div>\n

    Access via: http:\/\/localhost:8000<\/code><\/p>\n

    \n

    \ud83d\ude80 Production Deployment (NGINX & Supervisor)<\/h2>\n

    1. Setup Production Environment<\/h3>\n
    \n
    \n
    \n
    <\/div>\n<\/div>\n<\/div>\n
    sudo bench setup production erpnext
    \n<\/code><\/div>\n<\/div>\n

    This installs:<\/p>\n

      \n
    • \n

      NGINX reverse proxy<\/p>\n<\/li>\n

    • \n

      Supervisor process manager<\/p>\n<\/li>\n

    • \n

      Auto-start services on boot<\/p>\n<\/li>\n<\/ul>\n

      2. Setup SSL (Optional)<\/h3>\n
      \n
      \n
      \n
      <\/div>\n<\/div>\n<\/div>\n
      sudo bench setup lets-encrypt erp.mysite.local
      \n<\/code><\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

      \ud83d\udcdd Table of Contents System Requirements Pre-Installation Database Configuration Frappe & ERPNext Installation Production Deployment (NGINX & Supervisor) Post-Installation Setup […]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":10,"menu_order":1,"comment_status":"open","ping_status":"closed","template":"","meta":{"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0,"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"default","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"set","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"doc_tag":[],"class_list":["post-14","docs","type-docs","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/docs.inbizsys.com\/index.php\/wp-json\/wp\/v2\/docs\/14","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.inbizsys.com\/index.php\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/docs.inbizsys.com\/index.php\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/docs.inbizsys.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.inbizsys.com\/index.php\/wp-json\/wp\/v2\/comments?post=14"}],"version-history":[{"count":3,"href":"https:\/\/docs.inbizsys.com\/index.php\/wp-json\/wp\/v2\/docs\/14\/revisions"}],"predecessor-version":[{"id":21,"href":"https:\/\/docs.inbizsys.com\/index.php\/wp-json\/wp\/v2\/docs\/14\/revisions\/21"}],"up":[{"embeddable":true,"href":"https:\/\/docs.inbizsys.com\/index.php\/wp-json\/wp\/v2\/docs\/10"}],"wp:attachment":[{"href":"https:\/\/docs.inbizsys.com\/index.php\/wp-json\/wp\/v2\/media?parent=14"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/docs.inbizsys.com\/index.php\/wp-json\/wp\/v2\/doc_tag?post=14"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}