Frappe dev · GitHub Codespaces

Deploy Frappe in a free development environment

One click launches a GitHub Codespace preconfigured for Frappe development. It provisions a free development setup (within your Codespaces quota) with Bench, a dev site, and containerized MariaDB and Redis, so you can start building without running servers locally.

After init completes in Codespaces

Wait until the setup log prints [init] Setup complete, then follow this checklist.

Run the web server in Codespaces terminal
```
cd /workspace/frappe-bench
bench start
```
Open the Ports tab in the Codespaces panel
In the same Codespace window, open Ports in the bottom panel. Wait until port 8000 appears after bench start is running.
Open port 8000 in browser
Click port 8000 and choose Open in Browser (or the globe icon). This opens the Frappe site URL for your Codespace.

You must be signed in to GitHub. Codespaces usage follows your account or organization’s plan and policies.

After the Codespace starts

First-time creation runs the devcontainer postCreateCommand (scripts/init.sh). This can take several minutes—watch the terminal or Codespaces: View Creation Log in the command palette.

Default site: dev.localhost. Typical login: Administrator / admin (see the template repo if that changes).

Forwarded ports often include 8000 (web), 9000, and 6787 per the template devcontainer.

Use your own fork

Fork frappe_mini, change scripts or dependencies, then open a Codespace from your copy:

https://codespaces.new/<your-user>/<your-fork>

This site can point at a different default URL at build time: set VITE_CODESPACE_NEW_URL in Vercel (see .env.example).

A complete Frappe bench, ready instantly

Clone apps, move customizations, and ship commits to GitHub from a fully prepared workspace in moments.

VS Code in Your Browser

Build, troubleshoot, and validate Frappe projects directly in the browser with no local setup.

Internet-Accessible Frappe Site

Launch a real Frappe site over HTTPS with MariaDB already wired in and ready to use.

Built-In GitHub Workflow

GitHub CLI is preinstalled so cloning repos, syncing branches, and pushing updates feels effortless.

Full Control Environment

Work in a complete Ubuntu machine with root privileges and add any packages or dependencies your stack requires.

Quick Health Check

See at a glance how your workspace is performing from your dashboard.

Run Only When Needed

Boot your dev box when you are working and pause it anytime, while keeping project data between sessions.