Ownware
Home›Jobora›Quickstart
Jobora · Quickstart

Jobora Quickstart, as shipped in the download

The QUICKSTART.txt in the download — the same steps your delivery email carries.

JOBORA — QUICKSTART
===================
Jobs, Quotes and Job Costing for a small field-service firm — self-hosted PHP + MySQL/SQLite.

REQUIREMENTS
------------
  * PHP 8.1 or later with PDO (pdo_sqlite or pdo_mysql). GD is recommended — the signature
    pad uses it to tell a signed pad from a blank one.
  * MySQL 5.7+ or SQLite 3 (SQLite needs nothing but a writable folder).
  * Apache with mod_rewrite, or Nginx with a try_files rule. No Composer, no Node, no build.

INSTALL
-------
  1. Upload the contents of app/ to your web root (or a subfolder).
  2. Make data/ writable by the web server:   chmod 775 data
  3. Open  https://your-site/install/  in a browser and complete the form.
     The installer writes config.php and creates the schema.
  4. Log in with the administrator account you just created.
  5. DELETE or password-protect the install/ folder.

FIRST FIFTEEN MINUTES
---------------------
  1. Settings — company name, currency, your labour rate per hour, and your prefixes.
  2. Team — add your technicians. Each one gets a lane on the schedule board.
  3. Customers — add one, or import a CSV you already keep.
  4. Quotes — price a job and mark it sent. The customer gets their own link and can accept it,
     which creates the job for you.
  5. Schedule — drag the job onto a day. A clash with the same technician is refused.
  6. On the job: log materials and hours as you go, attach a before and an after photo, and take
     the customer's signature at the door.
  7. Raise the invoice from the job when it is done.

WANT TO SEE IT FULL FIRST?
--------------------------
  Settings -> Load demo data. Twenty jobs across a fortnight, with quotes, costs, sign-offs and
  two invoices — including one job that lost money, so you can see what the margin view is for.
  Settings -> Reset all data clears it again and leaves your staff and settings alone.

EMAIL
-----
  Jobora emails a customer only when you switch it on, and only through YOUR SMTP server.
  There are two gates in Settings: a master switch, and a tick per message. Both ship OFF.
  A mail failure never breaks the thing that triggered it — the reason lands in the outbox.

BACKUPS
-------
  Settings -> Backup & restore. Download a JSON or SQLite backup any time, or point a cron at
  the token-guarded URL. Restore always shows you a dry-run diff before it writes anything.

API AND AI ASSISTANTS
---------------------
  Settings -> API & webhooks mints a key. Choose "Read only" for an assistant that should answer
  questions but never change anything. See API.md for the connect recipe.

SUPPORT
-------
  Everything is in README.md and API.md, including an honest list of what this product does not do.

← Back to Jobora · Manual · API · Test run

Affiliate program
Recommend tools people own — earn 35% on every sale. 90-day tracking, instant delivery, payouts by Lemon Squeezy.
Become an affiliate →