Support
Help with Millo
Email support@millo.ca and include what you were doing and what you saw. A screenshot helps. We answer within two business days.
Millo doesn't open in my browser
Give it half a minute on the first start while it prepares its records, then open http://localhost:3100 yourself. If it still isn't there, open Millo again from your Applications folder. Its log is in the logs folder inside ~/Library/Application Support/Millo. On a Windows PC, open Millo again from the Start menu; its log is in the logs folder inside %APPDATA%\Millo.
Phones can't reach Millo
Check that the phone is on the same network as the computer running Millo, and that the computer is awake. Use the computer's number on the network with :3100 on the end, for example http://192.168.1.20:3100; iPhones can also use the computer's name. Settings, then Phones, shows both, with a code to scan that carries the number.
Away from the office, Millo Hub has to be on (Settings, then Advanced, then Phones from job sites; use Test the address there), the computer running Millo has to be awake, and the phone has to be paired. A phone that says "Pair this phone" needs a new code from the office: Settings, then Phones, then Pair a phone.
I forgot my PIN
Owner: on the Mac that runs Millo, open Terminal and type /Applications/Millo.app/Contents/MacOS/Millo --reset-owner-pin, then a new PIN twice. Millo can stay running; you're signed out everywhere and sign in again with the new PIN.
Everyone else: ask the owner. They open Crew, then Sign-in accounts, and choose Reset PIN.
Backups and restoring
Millo backs up your records, files and settings every night to the folder in Settings, then Backups. Choose a folder on a USB drive or network drive so a lost computer doesn't take your backups with it.
To restore, sign in as the owner, open Settings, then Backups, press Restore… beside the backup you want, tick that you understand work entered after it was made won't be in Millo, and press Restore this backup. Millo checks the backup, restarts and puts it in place, usually within a minute; phones can't reach Millo until then. Nothing is deleted: what was in Millo moves into a folder named "before restore" and the date, inside your records folder. Work entered after the backup was made isn't in it. Everyone signs in again with the PIN they had then, but anyone stopped from signing in since the backup still can't, and a phone removed since stays removed. A phone paired after the backup pairs again. Phone pairing, Millo Hub's settings and the master PIN stay as they are now.
Restore is in Millo 0.1.8 and later. For an older Millo, or to restore by hand, the Backups page lists every step under How to restore a backup.
Moving Millo to a new computer
Install Millo on the new computer but don't set it up. Make an empty records folder there (Application Support/Millo in the Mac's Library, or %APPDATA%\Millo on a Windows PC; if Millo has already opened and made one, stop Millo and move that folder aside first). Copy datum.db, the files folder and, if it's there, secrets.json from inside your latest backup into it, then open Millo. Everything, including your sign-ins, comes with it. Copying the backup folder itself in restores nothing: Millo looks for datum.db at the top of the records folder.
Finish by choosing the Millo folder and the backup folder again under Settings, then Files, and Settings, then Backups. Both are paths on the old computer until you do, so Settings says the Millo folder is unreachable and the backup folder is missing, and backups don't run.
The assistant is slow or won't answer
The first request after a restart loads the model, which can take a minute. If every request is slow, open Settings, then Advanced, then Assistant, and choose a smaller model, or use an API key instead. Check that Ollama is running; the Assistant section there tells you.
Changing the company name, logo or colours
Settings, then Company. Changes apply to the app straight away and to every document made afterwards.
Adding a crew member
Open Crew, add the person with their trade, wage and start date. Their page opens with Getting them started: create their sign-in with a starting PIN (they choose their own PIN the first time they sign in), then work down the list.
Someone leaves
Open their page and press Moved on. Give their last day and why, and choose whether their sign-in stops now or at the end of that day. Millo takes them off the job crews, passes their open to-dos on, and lists what's left to finish: final pay, the Record of Employment in Ontario, and anything they still have of yours. Their hours and documents stay. If they come back, re-hire them from Crew, then Archived.
A job says Needs attention. Why?
On Today, Needs you lists everything waiting on the office. Every item says how much money is involved, why, and what to do next. A job needs attention when what's billed and not billed yet comes to more than its contract value, or a budget line is over its estimate.