01
Install LotNomic
Deploy the current ZIP on the Linux server. The app uses port 8081 and keeps its job database/results in the persistent Docker volume.
LOTNOMIC MANUAL · v0.2.9
How to use
LotNomic.
The MVP imports an auction run, checks structured retail listings, estimates market value, ranks acquisition opportunities, and keeps every run available after you close the browser.
LOCAL MARKET100 mi around 78681
FALLBACKTexas statewide
MARKET PROVIDERAuto.dev
INPUTSCSV · Excel · Google Sheets
FIRST-TIME SETUP
Configure market data once.
02
Add Auto.dev
On Linux, run ./configure-auto-dev.sh. Paste the API key into the hidden prompt. The key is stored server-side in .env and is never rendered in the website.
03
Verify provider
The Valuation page and Jobs page show whether Auto.dev is configured. /healthz also reports provider configuration without exposing the key.
04
Test five cars first
Use the packaged five-row smoke-test CSV before sending a full auction run.
RUN A VALUATION
Upload and let the server work.
01
Choose input
Upload CSV, XLSX, XLS, XLSM, or paste a downloadable Google Sheets link. Required fields are Year, Make, Model, Odometer, and Price.
02
Local search
For each vehicle, LotNomic requests used listings for the same year/make/model within 100 miles of ZIP 78681.
03
Texas fallback
If fewer than three useful local comps remain after matching/filtering, LotNomic makes a statewide Texas request.
04
Review the estimate
The market value is the median accepted asking price. The run retains comp count, confidence, scope, listing links, spread, and ROI.
ACTIVE RUNS
You can close the browser.
The valuation worker runs on the Linux server, not in your browser tab.
Return from Valuation
The Valuation page has an Active Runs panel and a Recent runs table. Click Open run to return to live progress.
Return from Jobs
Jobs lists every run with Status, Started by, Progress, provider/activity, heartbeat, elapsed time and an explicit Open button.
Know if it is alive
An active run updates its worker heartbeat while searching. The run page shows current vehicle, current provider, provider phase and elapsed time.
JOB CONTROL
Control the queue.
Kill
Admins may stop any active/queued job. Regular users may stop their own jobs. Active cancellation is graceful at the next safe provider checkpoint.
Cancel queued
Admins can cancel the whole queued backlog without stopping the Docker worker.
Clean finished
Admins can remove done, failed and cancelled job records and their stored result files when no longer needed.
TROUBLESHOOTING
Use diagnostics before reinstalling.
Provider not configured
Run ./configure-auto-dev.sh in the current LotNomic install folder. Do not paste the API key into chat or source code.
Run failed
Open Jobs and open the failed run. LotNomic stops the whole run on provider authentication/rate/network failures rather than silently producing 93 blank values.
Diagnostics
Run ./diagnose.sh. It reports Docker, jobs, Auto.dev connectivity/auth status, logs, and health without printing the API key.