Running Frappe/ERPNext on Windows with WSL — A Web Developer’s Perspective

Aditya — Wed, 22 Oct 2025 06:35:54 +0000

🚀 How It Started

I’m a MERN-stack developer exploring ERP software then I come to know about ERNnext based on Frappe, an open-source Python + MariaDB framework.
While trying to set it up on Windows, I quickly learned:

Frappe runs perfectly on Linux/Mac, but fails on native Windows.

So I had to learn why, and how to make it work using WSL (Windows Subsystem for Linux).

⚙️ Why Frappe Doesn’t Run on Windows Directly

Unlike Node.js (which runs anywhere), Frappe depends on:

MariaDB (SQL database)

Redis (caching + background jobs)

Gunicorn/Werkzeug (Python web server)

Supervisor/Nginx (process control)

These tools are Linux-native.
They expect a Linux-style filesystem, bash commands, and POSIX permissions — things Windows doesn’t provide.

💻 What WSL Does

WSL (Windows Subsystem for Linux) acts like a lightweight virtual Linux computer inside Windows.

It gives you:

a real Linux kernel

Ubuntu filesystem (/home/)

package manager (apt)

shared network + hardware

So you can run sudo apt install, redis-server, mysql, and other Linux tools — directly inside Windows.

📂 The Linux files actually live inside:

C:\Users<Name>\AppData\Local\Packages...\ext4.vhdx
Windows just mounts it for you.

🏗️ Installing Frappe in WSL (Simplified Steps)

# open Ubuntu (WSL)

sudo apt update && sudo apt upgrade

sudo apt install python3-pip redis-server mariadb-server

pip install frappe-bench

bench init frappe-bench

cd frappe-bench

source env/bin/activate

bench new-site dev.localhost #new site name 

bench start

Now open http://localhost:8000 or http://dev.localhost:8000/

🧠 Why “bench” Exists

bench is a command-line tool that:

Initializes new Frappe projects

Starts servers (web, Redis, workers)

Handles database migrations

Installs apps like ERPNext

Basically, it’s your Frappe DevOps manager.

So think of:

Bench = npm + pm2 + nodemon for Python

💡 How VS Code Fits In

You can open your WSL folder in VS Code:

\\wsl$\Ubuntu\home\<user>\frappe-bench

and then run bench start in VS Code’s WSL terminal.
The editor runs in Windows, but the code executes inside Ubuntu — the best of both worlds.

⚡ Key Takeaways

Frappe = full-stack Python framework with its own ecosystem.

Windows can’t run it directly → needs WSL (Linux inside Windows).

WSL shares your PC’s CPU, RAM, and disk but acts like Ubuntu.

bench manages everything — like npm + pm2 for Frappe.

You can code in VS Code and run in WSL seamlessly.

✅ Example Setup Recap

# Activate virtual env
source ~/frappe-bench/env/bin/activate

# Start Frappe
bench start

# Access site
http://localhost:8000 or http://dev.localhost:8000/

✨ Closing Note
At first, setting up Frappe on Windows feels confusing — but once you understand WSL as your Linux bubble, it all clicks.

🚀 Project: StayFinder – A Minimal Airbnb Clone

Aditya — Wed, 25 Jun 2025 18:40:37 +0000

Built with:

Frontend: React.js, Tailwind CSS
Backend: Node.js, Express.js
Database: MongoDB
Cloud Storage: Cloudinary (for image upload)
API Testing: Postman
Deployment: Vercel (Frontend), Render (Backend)

🛠️ Why I Built This

I built StayFinder as part of a task during an internship application. The goal was to replicate core Airbnb functionality – listing properties, image uploads, user interactions, and availability scheduling – all using RESTful APIs.

This project helped me get hands-on with full-stack development: from creating intuitive UI to setting up secure backend routes and managing a NoSQL database.

🌐 Live Preview + GitHub

Live Demo: [https://stay-finder-theta.vercel.app/]

GitHub: [https://github.com/aditorito/StayFinder]

💡 What I Learned

Creating and consuming RESTful APIs

Image handling and upload via Cloudinary

Managing availability dates using MongoDB

Building a responsive UI with Tailwind

Deployment on Render and vercel.

😫 Struggles & An Honest Ask for Help

I’m proud of the project — but I’m honestly frustrated building everything solo. It’s tough to learn, build, debug, and grow alone. I want to:

Collaborate on real projects with real people

Contribute to open-source and learn from others

Connect with mentors or interns like me

Get into a solid internship or part-time dev work

If you're working on something exciting or know someone hiring/inviting interns or contributors, I’d love to hear from you!
🤝 Let’s Connect
💬 Drop a comment if you have advice
👥 DM me if you're building something
🔗 Share open source or internship leads

Let’s build and grow together 💻💬🌱