Appearance

Host on Frappe Cloud ​

Frappe Cloud is managed Frappe hosting by the framework makers. Kamra is on the marketplace. The app is free. You pay Frappe for the site.

The other install path is self-host on your own VPS (Docker quickstart). Same software. Both paths on the website.

Install ​

Shared trial sites only get featured marketplace apps. Kamra needs a private bench (Frappe v16) and a site on a plan Frappe prices at USD 25 and above. Add a payment method first; private benches are not on the trial. Official Frappe docs: create a bench · create a site · install an app.

  1. Sign up for Frappe Cloud and add a payment method.
  2. Create a private bench group on Frappe v16, then a site on that bench.
  3. On the bench, Add App → Kamra from the marketplace. Deploy the update. On the site, Install App → Kamra. The payments app is pulled in automatically.
  4. Open https://<your-site>/kamra. Sign in as Administrator (or [email protected]) with the site password you set at create-site. There is no default Kamra password. Run /kamra/setup.

Marketing walkthrough with the same steps: kamrapms.com/frappe-cloud/.

For a product walkthrough after install, use the live demo — that is the same packaged SPA a Marketplace install serves.

What a Marketplace install actually does ​

Frappe Cloud clones Kamra-PMS/kamra-pms at the approved main SHA, installs payments, then bench --site <site> install-app kamra. It does not run npm. The UI is the committed build under kamra/public/frontend.

That is why every release must keep:

  • pyproject.toml with requires-python >= 3.10 and Frappe >=16.0.0-dev,<17.0.0
  • required_apps = ["payments"]
  • add_to_apps_screen + /kamra/<path:app_path> route
  • the prebuilt SPA (index.html pointing at /assets/kamra/frontend/)

Simulation we run before each release ​

Two layers, both in GitHub Actions:

  1. Offline pack check (python kamra/scripts/marketplace_install_check.py) — the same gates FC's auditor cares about, without MariaDB.
  2. Full bench path (CI job Backend eval harness) — bench init → get-app payments → get-app kamra → new-site → install-app kamra → eval harness + front-desk journey + fresh-install role/SPA asserts.

Locally (from a clone of main):

bash
python kamra/scripts/marketplace_install_check.py