Wizard won't finish

@clarkej - Thanks, John…that appears to be a good workaround. With a small effort, should be able to make a Bench CLI command that does that.

@scmmishra - I’ve seen nothing that indicates OS or version makes any difference. Bug has existed since at least version 7. That being said. I know for a fact it’s happened on a freshly-installed Ubuntu 18.04 with ERPNext version 12. You can start there, if you want to experiment.

Hey Clarke,

That link is hugely helpful.

Ultimately I’m going to go with this genius recommendation from that thread:

Meanwhile this is kind of a “WTF” for me:


I would like to use the setup_complete(args) RPC that @revant_one suggested, but I would need all those different data points to be documented. Is that available somewhere?

FYI, I completed a clean install this morning. Ubuntu 18.10, ERPNext version 12. No errors during installation. No errors upon bench_start

Logged into http://localhost:8000, and completed the Setup Wizard.

First Attempt: Wizard failed for no apparent reason. Gave me option to “Retry”. So I clicked that.

Second Attempt: Wizard appeared to be working. The progress bar never moved. But my CPU was being utilized. So I patiently waited. Eventually, I was told the installation completed. However…my new user didn’t have access to DocTypes, and my browser refused to show any pages. Refreshing did not work. Browser page totally frozen.

Third Attempt: Closed my browser completely, and re-opening to http://localhost:8000. Was allowed to login as Administrator.

Setup Wizard is still unreliable, broken, and only succeeds intermittently. Needs Rework.

Another day. Another ERPNext installation. This time for one of my clients. Ubuntu 18.04, ERPNext v12.3. Browser used was Opera.

No errors this time. The Wizard took a long time to complete. 4+ minutes. During this time the progress bar never moved a micron. I thought about giving up, but just kept starting at the screen, and the terminal where Bench was running. Then it finally refreshed, and took me straight to Desk.

Why better today than yesterday? Who knows.

Done testing Bench installations for a while; have other ERPNext issues to solve first.

To be honest i am wondering why you guys are facing this wizard issue. I have tested on cloud VPS, bare metal local pc and virtual pc (virtualbox, vmware and Hyper-V) and in all cases, wizard completed without issues after fixing the do not panic error after easy install. I couldn’t reproduce this wizard error.

Yesterday I spent the early morning with an ErpNext 14-days trial account, and all the rest of the day with a virtual machine and the Bitnami installer.

I was trying to find any other way to get the Wizard to work once, JUST ONCE, so I could back up the database and have it available to restore where I want it.

The trial account uses a different Wizard (is anyone surprised). It asked most, but not all of the questions of the publicly available Wizard. When I ran the backup I discovered that for the trial version the database archive is not included in the bundle (is anyone surprised).

So that was yet another dead end. On to Bitnami…

After figuring out how to workaround the defects in their installer (accepting that it set up mail services corrupts site-config.json) I found that it filled in some, but not all, of the Wizard stuff automatically, and worked ok, but did not set it up with what I wanted.

I ran bench drop-site then bench new-site and subsequent commands, and got to a clean Wizard.

After that, my experience was then the same as @brian_pond experienced yesterday: Wizard won't finish - #15 by brian_pond

… but then my second attempt, was like his third…

So I do now, at last, have a way to get a prepared database to work from.

I cannot explain why I had no problems with this 'til 10 days ago, then always problems with it since then. Nor can I explain why some people see it and not others.

The good news is I got some personal assistance from the founder @rmehta!! Yes!

He corrected the title of one of my posts to read “Is there any way at all to configure ERPNext without using the Wizard?” instead of “Is there any way at all to configure ErpNext without using the Wizard?”

It’s nice to see that he’s concerned about 10 days of my life down the toilet on a 3 year old unresolved defect.


@MartinHBramwell Lol this is funny but a good spin. I hope you find a way to get around the issue you’re facing because i have tried on different hosting platforms to replicate your issue but each time my wizard completes without any errors (maybe the wizard recognizes my noobiness and decided to conform :man_shrugging:).

1 Like

This difficulty of replicating the issue is why I tried the Bitnami route.

The only similarity to my previous attempts is in the host, an Ubuntu 18.04 LTS VM running in Xen running in Apache Cloudstack.

If someone wanted to give it a try, I’d spin up a copy and give them the root password.

We wonder that too.

I don’t think it’s funny. I think it’s sad, actually.

Eventually, if you keep trying again and again, the wizard works.

Martin and I aren’t the only people to experience this issue. There have been dozens over the past 3 years. Searching the forums, you can see the old posts.

However. After you successfully install ERPNext from scratch and get it working, how often does a normal person repeat the process again? Probably not often. Because once it’s running, you want to use it. That was the whole point of installing in the first place.

So the people seeing this problem are mostly first-time users (or consultants who install ERPNext for a living).

But the bug is intermittent. It doesn’t always happen.

And those are the worst bugs to resolve.

Just for the records, we ALWAYS have this problem. In this version and in the previous ones.

1 Like

For me this is reproducible 100% of times, and unlike Brian, a loooong wait doesn’t solve it.

Simply spin up the downloadable VM with a brand new ERPNext and start the Wizard - then choose as Country “South Africa” and GMT+2 (Pretoria/Harare) as the timezone. The wizard swill never finish.

2 Notes:
1 - I’m still using v11, did not move to 12 yet, perhaps it works better?
2 - If I choose “Botswana” in stead of South Africa, it works, which makes me think a previous mention of the culprit possibly being in the timezone/UoM or some localization settings might be on to something.

Currently, every Demo I do for a prospective ERPNext company I have to do this trickery of first picking Botswana, finishing the Wizard, then rectifying all the Botswana settings back to S.A. settings in setup, explaining to the client that it’s a temporary wizard deficiency only and won’t affect the actual system use.

It’s highly irritating though, I wish it wouldn’t.



A broken Wizzard sucks. So nobody want to start with a broken Software from the beginning.

It seems it works for the developers, but not for newcomers.

Until the developers reach out to someone who is blocked by the broken Wizard, get permission to look into their server and figure out the cause, nothing will change.

If it was my product that’s what I would do.

If asked I would be pleased to have them look around my disposable virtual machine.

It depends on someone giving a shit, doesn’t it?


If you install on google cloud, there is no problem.

If you install on local computer, especially using virtualbox, I always encounter this.
All I do is retry, or open the site at the browser and repeat the setup process. It eventually goes through. If you are on develop mode, you will see the logs on the console that the setup somehow reaches a new stopping point as you retry. (On production mode, you can also see this in the logs.) This has something to do with how powerful the computer you are using, I think.

@MartinHBramwell can i try a fresh install on your disposable VM? I did a fresh install a few hours ago to test v12.5.2 and it went without a hitch.

1 Like

I am travelling right now and not really in a position to work with you on that.

I’ll let you know.

I should add :

@flexy2ky, @rmehta

If an ERPNext development team member contacts me and says, “This is a really bad thing for everyone and can’t continue. I’m determined to fix it once and for all. Let’s look at it together”, then I’ll make the time.

I wish I had higher hopes.

1 Like

I can confirm, I have seen this multiple times. Even on a fresh install on a mac. Something to do with NodeJS conflict (I am not a developer, but was told so).

I have seen this on my server too. But when I refresh the browser, it takes me to the desk just ok. I use my server for testing concepts etc. I dont know what the solution is, but to scream doesn’t help.

Solve it if you are capable and post it. Else, pay someone to find the issue and share with the community.

The highest hope you can have is from oneself / yourself. Not someone who you pay nothing and owes you nothing. That hope should be : That one day you will contribute to about 10% of the of the total code that already is in ERPNext. Or 10% of anything like docs.

Ask not what the community can do for you. Ask what you can do for your community.

@Not_a_countant. I do understand where you’re coming from. In many ways, I strongly agree with you. You’re speaking about taking initiative. Ownership. Becoming a contributor. Building a community.

However. The first step of any software is Installation. The ERPNext installation is awful. Once you make it past installation, you may encounter this Wizard bug. A bug that’s widely known in the community, and has existed for 3+ years.

What would be the first-impression of a newcomer about ERPNext and its community? A community that praises software that doesn’t even install cleanly. What does that say about the quality of the software? The quality of people in the community? A community that now expects newcomers to solve their 3+ year old Installation Wizard bugs?

I expect the newcomer might run. Quickly. And go find another product. Does it matter if ERPNext is the “#1 open source ERP”, if you cannot successfully install it?

How can we suggest newcomers pay to solve our lingering Installation bugs? Why should they invest money in a product they cannot even see, or try out? This isn’t Kickstarter. It’s supposedly an existing, stable product.

Very likely, newcomers will conclude that if ERPNext fails on installation, the rest of the software is probably of similar poor quality. They’ll walk away, never come back. And if anyone asks about ERPNext, they’ll share the story of how its Installation Wizard locks up.

Now, if you’re already part of the community, using the software, and you want a feature added? A new report, or a new module, or a new integration? Sure. Definitely build it yourself. Or fund someone else’s development effort. Fund a pool to go hunt down bugs too, if you like.

But I feel the new people trying to install ERPNext owe the community nothing.

In addition, I feel the community/maintainers should either:

  1. Deliver a product that installs cleanly.
  2. Or if they cannot, then officially announce that ERPNext is a Beta tool, not ready for release, until its fixed. Stop advertising it as a substitute for SAP, Dynamics, Oracle, or whatever. Those packages actually install consistently. They also don’t expect their users to learn Bash and Python to debug installation issues.

I have encountered the wizard hang several times over the last few years. Combine the broken wizard with the broken setup script, and the new user setup experience becomes unpleasant to put it mildly.