Central is the new control plane for Frappe Cloud v2. It manages IAM, billing, add-ons and other services. The regional VM runtime is managed and operated by Atlas.
- Python 3.14
- Node.js 24 and Yarn
- MariaDB 11.8 and Redis 6+
- Frappe Bench
The Frappe installation guide covers the system dependencies and Bench setup.
The commands below create a fresh Bench and a Central site. Run them from the Bench root.
bench get-app central https://github.com/frappe/central.git
bench setup requirements --dev
bench new-site central.localhost --admin-password admin
bench --site central.localhost install-app central
bench --site central.localhost set-config developer_mode 1
bench build --app centralIf MariaDB requires a root password, add --db-root-password <password> to
bench new-site.
Start the Bench:
bench startOpen Central at http://central.localhost:8000/app and sign in as
Administrator with password admin.
Enable developer mode before running the local bootstrap. It creates sample teams, users, billing records, and catalog data.
bench --site central.localhost execute central.api.developer_setup.setup_localTo reseed without registering Atlas:
bench --site central.localhost execute central.api.developer_setup.setup_local \
--kwargs '{"register_atlas": 0}'Install Atlas on a second site when you need to test Central-to-Atlas flows:
bench get-app atlas https://github.com/frappe/atlas.git
bench new-site mumbai.atlas.localhost --admin-password admin
bench --site mumbai.atlas.localhost install-app atlas
bench --site mumbai.atlas.localhost migrateGenerate an Administrator API key and secret in Atlas at
User > Administrator > API Access > Generate Keys, then register the local
Atlas site with Central:
bench --site central.localhost execute central.api.developer_setup.setup_local \
--kwargs '{"region":"in-mumbai","atlas_base_url":"http://mumbai.atlas.localhost:8000","atlas_api_key":"<atlas-api-key>","atlas_api_secret":"<atlas-api-secret>"}'For a provider-free Atlas demo fleet:
bench --site mumbai.atlas.localhost execute atlas.atlas.demo.run --kwargs '{"reset": true}'See the Atlas bootstrap guide for real provider setup. It creates billable infrastructure.
The primary console is in console/. The older dashboard remains in
dashboard/ while it is being migrated.
cd apps/central
yarn install
yarn dev # primary console
yarn dev:legacy-dashboardFor a production-style build served by Frappe:
yarn build
bench build --app centralRun the Python test suite from the Bench root:
bench --site central.localhost run-tests --app centralRun the focused local bootstrap tests:
bench --site central.localhost run-tests \
--app central --module central.tests.test_developer_setupThe end-to-end suite requires a running Bench and payment-gateway test keys.
See e2e/README.md for setup and commands.