Fully Automated Install Script for ERPNext Version 14

inspired by the work of @abrefael, I have created a script that installs ERPNext production with almost no interaction. It also includes the option to SSL 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.

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


Will try on a new VPS , thanks for contribution

1 Like

UPDATE: Support added for Ubuntu 20.04 LTS and Debian 10 (Buster). Partial support for Debian 11 (Bulls Eye). SSL Certificate issuance is currently failing on Debian 11 due to lib.X509_V_FLAG_CB_ISSUER_CHECK error. I am currently working to fix that error and once done an update will be deployed.

I also added error handler to stop the script at any point if an error is encountered. I will continue to improve the script as I develop it.

shows error:rm: cannot remove β€˜/home/frappe/.my.cnf’: No such file or directory

1 Like

@Lei_Huang Thanks for the catch. I’ve removed reference to the file. I had set up a temp .my.cnf file to hold the mysql password during install but decided to hold it in a variable instead as it is more secure than saving the file in plain text while the script is running.

UPDATE: Full support for Debian 11 (Bulls Eye) has now been achieved. However, I am finding it difficult adding CentOS to the mix as I can’t seem to get bench production command to run on CentOS. If anyone has a working manual production install process for CentOS please share so I can adapt it to the auto install process.

UPDATE: Added option for setting up site for development only.

It appears CentOS is no longer supported as Production environment setup fails on CentOS and even official documentation states only Debian/Ubuntu and MacOS are officially supported. So at this point I am giving up trying to add support for CentOS as it just won’t work.

If anyone is able to find a way to install on CentOS I would very much appreciate such a walkthrough.

Great job.

It works perfectly under ubuntu 22.04 in hyper-v.

In wsl2 the script exits at 50% progress

@jls Thanks for the feedback. I haven’t really tested the script on wsl but I’ll add that to my ToDo list and ensure compatibility.

1 Like

The script stuck at Mariadb setting

@CA_B.C_Chechani Thanks for the feedback. Can you assist with any information that will enable me troubleshoot? For instance, what Distro and OS version did you run on and was there any error displayed? if yeas, please share the error so I can use it to troubleshoot.


I managed the issue encountered, and it’s running. I will instruct someone in my team to try so we understand what the case was. Thanks. Your script is very useful. But as someone suggested already if we can have multiple parts and call one by one at different stages may be useful.

Thank you for making this wonderful script.

@CA_B.C_Chechani Thanks for the feedback. Indeed I am looking at the best way to break the script into multiple parts but the original intention was to make the script as an unattended ERPNext installer. However, I am working on satisfying both requests. I will release an update that will satisfy both intentions real soon.

Ubuntu 20.04.06 LTS

Collecting google-auth~=1.29.0 (from frappe==14.38.0)
  Downloading google_auth-1.29.0-py2.py3-none-any.whl (142 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 142.9/142.9 kB 32.3 MB/s eta 0:00:00
Collecting posthog~=3.0.1 (from frappe==14.38.0)
  Downloading posthog-3.0.1-py2.py3-none-any.whl (37 kB)
INFO: pip is looking at multiple versions of frappe to determine which version is compatible with other requirements. This could take a while.
ERROR: Package 'frappe' requires a different Python: 3.8.10 not in '>=3.10'
subprocess.CalledProcessError: Command '/root/frappe-bench/env/bin/python -m pip install  --upgrade -e /root/frappe-bench/apps/frappe ' returned non-zero exit status 1.

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
  File "/usr/local/lib/python3.8/dist-packages/bench/commands/make.py", line 68, in init
  File "/usr/local/lib/python3.8/dist-packages/bench/utils/render.py", line 105, in wrapper_fn
    return fn(*args, **kwargs)
  File "/usr/local/lib/python3.8/dist-packages/bench/utils/system.py", line 79, in init
  File "/usr/local/lib/python3.8/dist-packages/bench/app.py", line 444, in get_app
    app.install(verbose=verbose, skip_assets=skip_assets, restart_bench=restart_bench)
  File "/usr/local/lib/python3.8/dist-packages/bench/utils/render.py", line 126, in wrapper_fn
    return fn(*args, **kwargs)
  File "/usr/local/lib/python3.8/dist-packages/bench/app.py", line 242, in install
  File "/usr/local/lib/python3.8/dist-packages/bench/app.py", line 573, in install_app
  File "/usr/local/lib/python3.8/dist-packages/bench/bench.py", line 48, in run
    return exec_cmd(cmd, cwd=cwd or self.cwd, _raise=_raise)
  File "/usr/local/lib/python3.8/dist-packages/bench/utils/__init__.py", line 158, in exec_cmd
    raise CommandFailedError from subprocess.CalledProcessError(return_code, cmd)

ERROR: There was a problem while creating frappe-bench
Do you want to rollback these changes? [y/N]: 

Another Error

Setting Up supervisor...
ERROR: [Errno 2] No such file or directory: './config/supervisor.conf'
Traceback (most recent call last):
  File "/usr/local/bin/bench", line 8, in <module>
  File "/usr/local/lib/python3.8/dist-packages/bench/cli.py", line 127, in cli
  File "/usr/local/lib/python3.8/dist-packages/click/core.py", line 1130, in __call__
    return self.main(*args, **kwargs)
  File "/usr/local/lib/python3.8/dist-packages/click/core.py", line 1055, in main
    rv = self.invoke(ctx)
  File "/usr/local/lib/python3.8/dist-packages/click/core.py", line 1657, in invoke
    return _process_result(sub_ctx.command.invoke(sub_ctx))
  File "/usr/local/lib/python3.8/dist-packages/click/core.py", line 1657, in invoke
    return _process_result(sub_ctx.command.invoke(sub_ctx))
  File "/usr/local/lib/python3.8/dist-packages/click/core.py", line 1404, in invoke
    return ctx.invoke(self.callback, **ctx.params)
  File "/usr/local/lib/python3.8/dist-packages/click/core.py", line 760, in invoke
    return __callback(*args, **kwargs)
  File "/usr/local/lib/python3.8/dist-packages/bench/commands/setup.py", line 108, in setup_production
    setup_production(user=user, yes=yes)
  File "/usr/local/lib/python3.8/dist-packages/bench/config/production_setup.py", line 52, in setup_production
    generate_supervisor_config(bench_path=bench_path, user=user, yes=yes)
  File "/usr/local/lib/python3.8/dist-packages/bench/config/supervisor.py", line 72, in generate_supervisor_config
    with open(conf_path, "w") as f:
FileNotFoundError: [Errno 2] No such file or directory: './config/supervisor.conf'
Setting Up prerequisites...
Setting Up supervisor...

From the error log it appears Python3.10 upgrade was not successful as indicated here:

INFO: pip is looking at multiple versions of frappe to determine which version is compatible with other requirements. This could take a while.
ERROR: Package 'frappe' requires a different Python: 3.8.10 not in '>=3.10'
subprocess.CalledProcessError: Command '/root/frappe-bench/env/bin/python -m pip install  --upgrade -e /root/frappe-bench/apps/frappe ' returned non-zero exit status 1.

You can remove the frappe-bench directory, re-run the script and watch for python3.10 prompt:

It appears this instance does not meet the minimum Python version required for ERPNext 14 (Python3.10)…

And if the installation was successful, you will see this prompt:

Python3.10 installation successful!

This will confirm that Python3.10 was installed successfully.

You can also run python3.10 --version to check if it was installed successfully.

need python3.10 for erpnext14

Thanks, @flexy2ky and @vrerg for the reply.

I am upgrading Ubuntu 20 to 22 then i will tray again.

@Suresh_Thakor If you’re setting up a cloud VPS then you’re better off using Ubuntu 22.04 directly as it comes with Python3.10 by default. If you’re setting up in a local environment then download Ubuntu 22.04 instead of upgrading as upgrading the OS version may not include an upgrade to the python version. although the script is designed to assist with upgrading to python3.10 if not available and this has been tested extensively on all supported Distros so something else may have prevented the upgrade during your installation run.