PPropertyOS

Start here

Getting started

A clean walkthrough from sign-up to your first rent payment. Plan for about 30 minutes for the initial setup.

Create your organization

Head to /signup. Provide your organization name, default currency, and your admin email. The flow creates:

  • An organization scoped to a unique slug.
  • Your user with the SUPER_ADMIN role.
  • A 14-day trial subscription on the Starter plan.
  • A seed Chart of Accounts (Ugandan default — you can edit it).

Set your reporting currency

Your organization currency is the base currency used by every consolidated report (P&L, Trial Balance, Balance Sheet). Pick this before you post any GL entries — changing it later requires re-stating prior periods. Common East African choices: UGX,KES, RWF, TZS, USD.

The setup ladder

Once you're signed in, work down this list — each step unlocks the next.

  1. Add staff users. Settings → Users. Assign roles (ADMIN, PROPERTY_MANAGER, ACCOUNTANT, MAINTENANCE, OWNER). Each role sees only the modules it needs.
  2. Add your first property. Property Management → Properties → New. Include the building address, currency (defaults to org), and contact phone.
  3. Add units to the property. Either inline on the property page, or via Property → Units. Set rent amount, bedrooms, and unit type per unit.
  4. Add tenants. Tenants → New. National ID and phone are required; email is optional. The tenant won't get login access until you invite them from their profile.
  5. Create the first lease. Leases → New. Pick the unit, tenant, term dates, rent amount, deposit, and frequency. The lease goes into DRAFT until you mark it ACTIVE.
  6. Generate this month's rent charges. Rent → Generate. Active leases get their RentCharge rows for the current month, ready for collection.
  7. Wire up payments (optional). Settings → Communication for SMS, or your Flutterwave keys in .env for mobile money. See Payment integrations.

Verify it all balances

After you've recorded one or two payments, visit Accounting → Trial Balance for the current period. Total debits should equal total credits to the cent. If they don't:

  • Check that you didn't post a journal entry while a period was locked.
  • Look for unconverted multi-currency entries — they show on the per-currency breakdown card.
  • The Audit Logs page shows every change with who and when.