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