Installation
Installation

Services Item Code: INSTALL

Would you prefer to run ERPNext on your own hardware? No problem! We will install ERPNext on any suitable computer for you.

What are our minimum recommended hardware requirements?

  • Processor: 1x 64-bit CPU core
  • RAM: 2GB
  • Storage: 20GB (absolute minimum: 12GB)

Our recommendation will give your installation plenty of RAM plus some storage space for database growth, backups and attaching files to your documents. Anything more than this will be more responsive and give your business more space to grow into.

Contact Us if you need help

What is included?

This is for installation of vanilla ERPNext, our extensions are not included.

We can install on bare metal, Virtual Machine, VPS or container.

All setup of latest Ubuntu/Debian LTS, partitions, firewall, crowdsec & HTTPS certificate to give a fully operational secure server.

What will I need to provide?

  • The Server

    One condition that we must insist upon is that the end-customer and us have sole access to the server operating system with no other applications running. This serves several purposes: the security attack surface is as small as possible, performance, reliability, we are solely responsible for managing ERPNext, and there are no data protection or IPR issues.

    Server backups must be done externally by snapshot.

    We can set the server up for you, but here's some advice. We work with various cloud providers like AWS and IONOS, but any provider should be fine provided they adhere to our requirements. At time of writing (please check) we recommend a minimal Ubuntu 22.04 LTS install with the following requirements:

    • If you can configure a firewall with your hosting provider, only allow the following ports from any IP address:
      • SSH (TCP port 22)
      • HTTP (TCP port 80)
      • HTTPS (TCP port 443)
    • Choose any username for the server account, we normally use frappe or erp
    • Install your own SSH public key in ~/.ssh/authorized_keys, and ask us for ours to allow us to log in securely
    • You should set up a strong password, disable logins using passwords and only allow public key logins in SSH:
      # Ensure the following are configured in /etc/ssh/sshd_config
      MaxAuthTries 3
      PermitRootLogin no
      PasswordAuthentication no
      PermitEmptyPasswords no
      KbdInteractiveAuthentication no
      ChallengeResponseAuthentication no
      KerberosAuthentication no
      GSSAPIAuthentication no
      PubkeyAuthentication yes
      X11Forwarding no
      # sshd -t
      # remove rsa and dsa host keys in /etc/ssh
      # service ssh restart
    • Let us know the password for the account so that we can get root access
  • Domain Name

    To be able to access ERPNext, it needs to have an internet name like erp.your-domain.com. This is a DNS name and if you already have your own website, you probably own a DNS domain that you can reuse. You will need access to this domain to create two new DNS A type records. One for a test ERPNext instance, and one for your production instance. Choose any names you prefer, we recommend erp and test-erp. If you also want ERPNext to host your website, you should probably choose www.
    It's difficult to give more specific setup guidance because every DNS host is different.
  • Backup Destination

    You must have Google Drive, Dropbox or Amazon S3 storage available to receive database & file backups. Click on the links for more setup information. This ensures there is always an off-site backup of your important data. Ensure the account is secured appropriately to contain all of your important business data and files.
    We can set up other destinations at additional cost.
  • Email Server (optional)

    If you want to use the ERPNext email functionality, you must have access to POP/IMAP and SMTP servers. This could be as simple as creating a free GMail account. Outgoing email setup is handy for backup notifications too.