[deprecation] Easy install script is no longer supported

This is just an official announcement, it’s been breaking and unsupported for quite some time now. What was once supposed to be an “easy” install has grown into quite a monster and fails a lot of times.

There are far more reliable ways to install Frappe namely…

  • Frappe docker maintained by @revant_one This sets up development setup in like 2-3 command!
  • Manual install - for those who have decent experience with installing and managing things on bare metal this is also just 10-20 commands and easier to fix if something goes wrong.

This is a deprecation warning. We will be removing the relevant code from the repository in the coming months and moving it to a separate repository. If anyone wants to revive and maintain it you’re more than welcome.


Thank you to all the devs who contributed to the script over time.
All my installations so far has been using the script, without much hassle.



If easy install script was setting up 1 site (set as default site), 1 bench, no TLS local setup?

then following does the job:

# Install docker and docker-compose-plugin
curl -fsSL https://get.docker.com | bash
# Download compose file
curl -fsSL https://raw.githubusercontent.com/frappe/frappe_docker/main/pwd.yml -o compose.yml
# Start containers
docker compose -p frappe-bench up -d
  • Visit http://localhost:8080 after 5-10 minutes. If you visit before that it’ll show “site not found” or “internal server error”
  • Edit compose.yml to change passwords for database and administrator.
  • Understand the compose.yml and services in it for more advance setup.