Uncategorized

In this article, I will take a step-by-step approach to configure our newly installed ubuntu 22.04 OS to set up an environment and install ERPNext version 15. Let’s get to work! Prerequisites The below prerequisites are advised in order to get an optimal functionality of ERPNext on your server. Software Requirements Hardware Requirements Server Settings Update and Upgrade Packages Create a new user – (bench user) In linux, the root user processes escalated privileges to perform any tasks within the system. This is why it is not advisable to use this user on a daily basis. We will create a user that we can use, and this will be the user we will also use as the Frappe Bench User. Ensure you have replaced [frappe-user] with your username. eg. sudo adduser frappe Install Required Packages A software like ERPNext, which is built on Frappe Framework, requires a number of packages in order to run smoothly. These are the packages we will be installing in this step. Install GIT Install Python ERPNext version 15 requires Python version 3.10+. This is what we will install in this step. Install Python Virtual Environment A virtual environment helps in managing the dependencies for one software at one place, without having to interfere with other sections in the computer or server in which the software is running. Install Software Properties Common Software Properties Common will help in repository management Install MariaDB ERPNext is built to naively run on MariaDB. The team is working to have the same working on PostgreSQL, but this is not ready yet. Install Redis Server Install other packages ERPNext functionality also relies on other packages we will install in this step. These will load fonts, PDFs, and other resources to our instance. Configure MYSQL Server Setup the server When you run this command, the server will show the following prompts. Please follow the steps as shown below to complete the setup correctly. Edit MYSQL default config file Add the following block of code exactly as is: Restart the MYSQL Server Instal CURL, Node, NPM and Yarn Install CURL Install Node Install NPM Install Yarn Initialize Frappe Bench Switch directories into the Frappe Bench directory Change user directory permissions This will give the bench user execution permission to the home directory Create a New Site A site is a requirement in ERPNext, Frappe and all the other apps we will be needing to install. We will create the site in this step. Install ERPNext and other Apps Download all the apps we want to install The first app we will download is the payments app. This app is required when setting up ERPNext. Next, we will download ERPNext app Download any other app you may be interested in in a similar manner. For instance, if you need the Human Resource app to be installed, use the following command. Install all the apps on our site Install all the other apps you downloaded in the same way. For example, if you downloaded the human resource app, use the below command to install it. We have successfully setup ERPNext version 15 on ubuntu 22.04. You can start the server by running the below command: If you didn’t have any other ERPNext instance running on the same server, ERPNext will get started on port 8000. If you visit [YOUR SERVER IP:8000], you should be able to see ERPNext version 15 running. Please note that instances which are running on develop mode, like the one we just setup, will not get started when you restart your server. You will need to run the bench start command every time the server restarts. In the below steps, we will learn how to deploy the production mode. Setting ERPNext for Production Enable Scheduler Disable maintenance mode Setup production config Setup NGINX to apply the changes Restart Supervisor and Launch Production Mode If you are prompted to save the new/existing config file, respond with a Y. When this completes doing the settings, your instance is now on production mode and can be accessed using your IP, without needing to use the port. This also will mean that your instance will start automatically even in the event you restart the server. All the best! 🙂