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