Installation instructions are outdated

meraki · May 2, 2024, 2:16pm

i followed official instruction again and failed again;

Below i chose to install V15

instead given code i used sudo apt install git python3-dev python3-pip redis-server as in history (8) (given at the end of the post)

i did not use this because my version is 22.04

secure installation doesn’t work without sudo and there is no mariadb-client-10.3 since latest mariadb is installed (10.6) client must be 10.6 too.

at the beginning we chose to install V15 so we should install Node.JS 18 but you cannot install with given code, so from this url; GitHub - nvm-sh/nvm: Node Version Manager - POSIX-compliant bash script to manage multiple active node.js versions we get correct installation url but after installation npm doesnt work, to make it work, you have to run one of them below which suits you best;

bash: source ~/.bashrc
zsh: source ~/.zshrc
ksh: . ~/.profile

if you follow this you will get dependency error, but you have to, so you should use sudo apt-get -f install (48)

bench command doesn’t work you have to add it to path (50-51)

bench init frappe-bench doesn’t work you have to install sudo apt install python3.10-venv (58)

After solving everything i can not access to site because i didnot created an app or site, but when i tried to create an app i had supervisor error i could not fix it so i quit.

THAT’s IT.

Sorry i had to green out some information

History of commands;

 2  sudo apt upgrade
 3  sudo apt update
 4  sudo apt upgrade -y
 5  init 6
 6  sudo init 6
 7  sudo apt install git python3.11-dev python3.11-pip redis-server
 8  sudo apt install git python3-dev python3-pip redis-server
 9  python3 -V
10  sudo apt install software-properties-common
11  sudo apt-get update
12  sudo apt-get install mariadb-server
13  celar
14  clear
15  mysql_secure_installation
16  clear
17  paswwd root
18  passwd root
19  sudo passwd root
20  clear
21  mysql_secure_installation
22  clear
23  mysql_secure_installation
24  sudo mysql_secure_installation
25  apt-get install mariadb-client-10.6
26  sudo apt-get install mariadb-client-10.6
27  sudo nano /etc/mysql/my.cnf
28  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
29  nvm install 18
30  source ~/.bashrc
31  nvm install 18
32  node -v
33  npm install -g yarn
34  npm install -g npm@10.7.0
35  npm fund
36  npm update
37  npm fund
38  npm fund
39  apt-get install xvfb libfontconfig
40  sudo apt-get install xvfb libfontconfig
41  curl -o- https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-2/wkhtmltox_0.12.6.1-2.jammy_amd64.deb
42  ls
43  wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-2/wkhtmltox_0.12.6.1-2.jammy_amd64.deb
44  sudo dpkg -i wkhtmltox_0.12.6.1-2.jammy_amd64.deb
45  sudp apt install -f
46  sudp apt -f instal
47  sudp apt -f install
48  sudo apt-get -f install
49  pip3 install frappe-bench
50  PATH=$PATH:/home/${user}/.local/bin
51  export PATH
52  ls
53  bench --version
54  cd ~
55  bench init frappe-bench
56  sudo bench init frappe-bench
57  python3 -V
58  apt install python3.10-venv
59  sudo apt install python3.10-venv
60  bench init frappe-bench
61  ls
62  cd frappe-bench/
63  bench start
64  bench find .
65  bench new-app library_management

flexy2ky · May 2, 2024, 2:20pm

Hi @meraki you can try this easy install script on Ubuntu 20.04 or Ubuntu 22.04. GitHub - flexcomng/erpnext_quick_install: Unattended install script for ERPNext Versions, 13, 14 and 15

It doesn’t require any installation knowledge and only minimal input required and handles everything.

meraki · May 2, 2024, 2:23pm

@flexy2ky
thank you for reply, i know your script and i used it many times, thank you for such a great work.
But i want to install Frappe framework only, i don’t want to install ERPNext or any other app, just Frappe framework.

flexy2ky · May 2, 2024, 2:25pm

@meraki you can edit the script and remove the flags --install-app erpnext This will install frappe framework only.

meraki · May 2, 2024, 2:26pm

@flexy2ky
i am not sure if i can do it, is it enough to delete ERPNext installation flag?

flexy2ky · May 2, 2024, 2:27pm

@meraki Yes. i have done it multiple times. The flag just tells the script to add ERPNext as part of the site install but if you remove it, ERPNext will not be installed only Frappe. to be specific:

This line:

bench init frappe-bench --version $bench_version --verbose --install-app erpnext --version $bench_version

change to:

bench init frappe-bench --version $bench_version --verbose

and this line

bench new-site $site_name --db-root-password $sqlpasswrd --admin-password $adminpasswrd --install-app erpnext

change to:

bench new-site $site_name --db-root-password $sqlpasswrd --admin-password $adminpasswrd

meraki · May 2, 2024, 2:29pm

@flexy2ky

I will definitely try this.

Thank you.

flexy2ky · May 2, 2024, 2:36pm

let me know if it works

meraki · May 2, 2024, 2:37pm

Hi @rmehta, @umair,

some instructions are outdated or very confusing like the one we discussed here.
FYI.

meraki · May 2, 2024, 2:37pm

i will.

meraki · May 2, 2024, 4:16pm

it worked like a charm.
thank you for this great script.

as a suggestion you may ask user to whether continue to install ERPNext or not, or maybe you may ask at the beginning.

flexy2ky · May 2, 2024, 4:17pm

This is a good suggestion. I will look at including this as additional question to give the user the option to install ERPNext as part of the installation process.

Jake · June 10, 2024, 9:01pm

@flexy2ky
How do we give you money to ensure you keep that script updated?

Please, please, 5 years from now still be here. <3

flexy2ky · June 10, 2024, 10:18pm

My intention was not to get paid for the script that’s why i made it publicly available and I try to suggest it to anyone who is in need of installation guidance. I intend to continue to update it (so long as frappe remains truly free and open source which is now doubtful going by recent events). I am actually working on improvements to better handle logging so users can easily see errors if/when they occur. That update will be released soon.

Should you wish to show appreciation for my effort though, you can private message me and i’ll share info on how you can buy me coffee

chrislennon · June 10, 2024, 11:31pm

I have a development background, but I am not a big fan of docker. It just kind of ‘moves’ the complexity without solving it

I installed the frappe framework on Ubuntu version 24 step by step (I used the online instructions I did not try flexy2ky’s script as I was not aware of it)

I did get it working but it took a long time and many times I got errors. Fortunately the error messages gave clues on how to solve.

chrislennon · June 10, 2024, 11:32pm

what do you mean?

flexy2ky · June 10, 2024, 11:34pm

This has been implemented as part of the latest update pushed. Users are now given the option of installing ERPNext as well as HRMS. Other apps will be included in due course.

Jake · June 11, 2024, 7:44pm

I disagree. Docker is much easier. What’s hard about it is learning yet another syntax. I gotta be in the mood for that. Put off learning Kubernetes for a year because “I didn’t feel like it”

Essentially, docker is the install, and once you got the code(docker-compose file) you can set and forget with minor tweaks along the way.

Volumes and Db are mounted to the container. Or their own separate containers. Did you get a version that throws errors? No problem, delete that container and redownload the old version until erpnext folks iron out the issues.
Back up and running in as much time as it takes to nano docker-compose.yml and change erpnext version. 2 minutes.

On a manual install, if dependencies are updated along with the bork install… have fun fixing that.

Not sure what to backup? nano docker compose and checkout volumes. Or just use the inbuilt backup tool.

Don’t get me wrong, this script from @flexy2ky is a masterpiece, but docker has it’s advantages beyond what a manual install can provide. Flexy’s script is easier than a docker install, but docker is better/easier than a manual install imo.

chrislennon · June 12, 2024, 6:31am

You make some really good points there Jake. I guess I stand by my ‘docker moves complexity rather than solves it’ statement, just because that’s what I’ve observed. But I am open minded on it.

I guess also even if you take moving complexity there is an argument that the complexity should be moved - from regular developers to infrastructure experts. Then us regular devs could simply run a line or two of script and have everything magically set up for us

meraki · June 28, 2024, 11:42am

@flexy2ky This is nice to hear, Thank you. i will try.