How To Remotely Host ERPNext Database

Good software design will emphasize the importance of separating the database from the software application. The server where the database is hosted needs an extra layer of protection as it contains all the data. This is sometimes known as remote database setup. This can also be achieved in ERPNext and the Frappe Framework.

In this article I will demonstrate to you how this can be achieved with simple steps.

Setup the remote DB to accept remote connections

After you have installed your database in the remote server (You may use the script provided on my GitHub repository), you will need to set it up to allow remote connections by doing the following:

Edit MariaDB configuration file to accept remote connections by changing its bind-address from 127.0.0.1 to 0.0.0.0

sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf

Login to your MySQL and create a database user that Frappe will use to authenticate.

CREATE USER 'root'@'[IP ADDRESS FOR ERPNext HOST]' IDENTIFIED BY '[YOUR PASSWORD OF CHOICE]';

Grant the created root user permissions to make changes to the created databases.

GRANT ALL PRIVILEGES ON *.* TO 'root'@'[IP ADDRESS FOR ERPNext HOST]' IDENTIFIED BY 'YOUR PASSWORD OF CHOICE' WITH GRANT OPTION;

Flush the privileges to effect changes to the database and log out from MySQL.

FLUSH PRIVILEGES;

EXIT;

Restart MySQL server to effect all the made changes.

sudo service mysql restart

Setup your ERPNext or Frappe Framework Installation to connect to your remote Database

bench set-mariadb-host [IP ADDRESS FOR DATABASE HOST]

Restart supervisor if your instance is in production mode

supervisorctl restart all

If your instance is in development mode, restart bench

bench restart

At this point you may decide to test the connection or dive in and create a new site. The database that Frappe will create will be in the server you just set up 🙂

bench new-site erp.upeosoft.com --mariadb-root-password [YOUR PASSWORD OF CHOICE]