[Guide] How to install ERPNext v14 on Linux Ubuntu (step-by-step instructions)

TurkerTunali · May 1, 2023, 1:47pm

I can confirm that this procedure still works for also v13. We just changed some commands to v13 from v14.

Val07 · May 4, 2023, 4:21pm

Bjr jobtient tjt des messages d’erreur jai envoye une photo

trentmu · May 4, 2023, 4:39pm

The yarn install failed with an ECONNrefused message
…try installing yarn before you run the script

TurkerTunali · May 10, 2023, 12:34pm

This can change to

nvm install 16

Because it will install the latest of 16 which is 16.20 nowadays.

abrefael · May 11, 2023, 12:01pm

Managed to script it!
Enjoy!

flexy2ky · May 11, 2023, 12:08pm

@abrefael Awesome job with the script but it terminates at initialising frappe. It doesn’t include setting up production. Any particular reason why?

abrefael · May 11, 2023, 2:22pm

It’s possible.
However, I wanted to keep it general enough for whoever doesn’t want to install ERPNext, or just want to keep it as a development environment.
Plus, you need to log-off and log back in at this stage (at list before bench start) in order to add the nvm path to $PATH. So…

flexy2ky · May 11, 2023, 3:10pm

Not really. NVM returns the following commands to run immediately after install is completed which will enable you continue installation using the same terminal on the same session:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion

If you add this after the installation of nvm package manager you could continue with the same session. To also help users who wish to use the script to install all the way to production you could add a prompt to ask if they wish to continue to production after frappe-bench is initialised. If the Answer is yes then you may ask them to provide the site and other relevant data in order to complete the production setup and this will enable the script to continue to production (which may even include letsenctypt SSL setup).

Just my little suggestion to make a great script and contribution even greater. Kudos to you for your contribution though.

umarless · May 12, 2023, 10:22am

Installed ERPNext as guided here.

but getting below error.

bench start running in one terminal.

SS of another terminal…

here is the SS before starting bench…

@buildwithhussain @NCP request to Check and guide

NCP · May 12, 2023, 12:28pm

Hi @umarless,

please apply it.

sudo nano /etc/hosts

then add it like:

127.0.0.1 umar.localhost

Then check it.

Thank You!

pra17shant · May 12, 2023, 1:05pm

@umarless

bench --site <site-name> add-to-hosts

bench use <Your Site Name>

Finally

bench start

And Check browser.

umarless · May 13, 2023, 3:46am

Thanks @NCP and @pra17shant.

Its solved.

flexy2ky · May 13, 2023, 1:01pm

inspired by the work of @abrefael, I have created a script that installs ERPNext production with almost interaction. It also includes SSL installation from Letsencrypt.

Just supply your database password, site name and site administrator password when required and the script will handle the rest.

The script is currently compatible with Ubuntu 22.04 only for now but I am working on adding compatibility for Debian and CentOS.

I intend maintaining it long term and I welcome contributions to make the script better.

TurkerTunali · May 15, 2023, 8:04pm

We should also perform performance optimizations. Easy script was somehow attempt it a little bit. It is beyond my scripting capabilities.

github.com

frappe/bench/blob/73994eeb9490b518bbb7856aee1fbdee82deb7bd/bench/config/common_site_config.py#L52


      
          		return json.dump(config, f, indent=1, sort_keys=True)
          
          
def update_config(new_config, bench_path='.'):
          	config = get_config(bench_path=bench_path)
          	config.update(new_config)
          	put_config(config, bench_path=bench_path)
          
          
def get_config_path(bench_path):
          	return os.path.join(bench_path, 'sites', 'common_site_config.json')
          
          
def get_gunicorn_workers():
          	'''This function will return the maximum workers that can be started depending upon
          	number of cpu's present on the machine'''
          	return {
          		"gunicorn_workers": multiprocessing.cpu_count()
          	}
          
          
def update_config_for_frappe(config, bench_path):
          	ports = make_ports(bench_path)
          
          
	for key in ('redis_cache', 'redis_queue', 'redis_socketio'):

flexy2ky · May 16, 2023, 6:01am

Yes Easy Script attempted it a bit but one of the reasons Easy Script no longer works is because it tried to account for every kind of scenario and environment thus making it too bloated. I think installation scripts should be restricted to standard installations only while instance tuning should be exclusively based on individual preferences and done manually. This is because there are several tuning combination possibilities for every instance and a simple script, short of becoming an AI tool itself, cannot identify and account for each scenario perfectly.

TurkerTunali · May 16, 2023, 9:36am

Hmm you are correct.

Then we can consider generating another script for performance checks.

I also believe that installation script should have 3 stages. So that if anything fails user can points us to right direction.

Make operating system ready (Date control, updates and installing mandatory packages)
Installing bench
Setting site and apps.

flexy2ky · May 16, 2023, 9:50am

I am thinking of breaking the script into stages and also adding error handlers as well. I also intend allowing users to set up development instance if they don’t want to run production. The script will continue to be improved but my first priority is adding Debian and CentOS compatibility which I am currently working on. You can also contribute to it if you have the time.

flexy2ky · May 16, 2023, 9:12pm

I’ve added support for Ubuntu 20.04 LTS and Debian 10. Support for Debian 11 is partial as the production instance is installed successfully but I am currently getting errors with SSL installation on Debian 11. Once I fix that I will proceed to add support for CentOS. As soon as I’m able to finish these, I will begin to work on breaking the script into stages. Although I will want to keep the interaction to bare minimum to preserve the objective of the script as an almost no-interactive easy install script.

Val07 · May 17, 2023, 4:12am

Thank you

TurkerTunali · May 18, 2023, 11:25am

Great. I only use Ubuntu Server but some of my friends insist that ERPNext on CentOS perform much better.

Do you have any experince on that? To me, it should not bother much.