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 labor 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 two weeks, 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.

LOOKING AFTER IT (from 4.0)
---------------------------
  * Updates: open Updates in the menu, save your license key once, press Check for updates.
    Reaching 4.0 from 3.x is the last update by hand: replace the files; config.php and data/ stay.
  * Sample data: the installer offers to start with a sample; remove it later with one click.
  * Backups: "Back up once a day by itself" is on by default (/restore); add an S3-compatible bucket there for
    a copy somewhere else. The Health page (/health) says whether all of this is working.
  * On Nginx: use the server block in the manual ("On Nginx: keep data/ private", https://ownware.io/p/jobora/manual);
    it opens the installer and keeps data/ private.
  * One-line install for technical owners:
    curl -fsSL https://ownware.io/install.sh | sh -s -- jobora <your license key>

← Back to Jobora · Manual · API · Test run