Skip to main content

Maintenance & Nozzle Tracking

O.D.I.N. tracks scheduled maintenance tasks per printer and provides nozzle lifecycle management so you always know when service is due.

Scheduled Maintenance Tasks​

Navigate to Settings → Maintenance to manage maintenance tasks.

Maintenance tasks are templates (e.g., "Nozzle Inspection") that apply across all printers. Each task has:

FieldDescription
NameTask description (e.g., "General Cleaning")
DescriptionDetail on what the task involves
Interval (hours)Trigger after this many print hours since last completion
Interval (days)Trigger after this many calendar days since last completion
Estimated CostExpected parts/supply cost
Estimated DowntimeExpected printer downtime in minutes

Either the print hours or the calendar interval (or both) can be set. When both are set, the task becomes due when either threshold is reached.

Example Maintenance Schedule​

TaskApplies ToInterval (Hours)Interval (Days)
General CleaningAll printers5014
Nozzle InspectionAll printers500—
Belt Tension CheckAll printers500—
Build Plate CheckAll printers1000180
Firmware Update CheckAll printers—30

Click Seed Defaults to pre-load these tasks plus printer-model-specific tasks for X1C, P1S, and A1 (carbon rod lubrication, HEPA filter replacement, purge wiper replacement, hotend cleaning).

Completing a Task​

  1. Navigate to Settings → Maintenance → Status
  2. Find the task and printer you completed maintenance on
  3. Click Complete — this logs the maintenance action and resets the timer
  4. A recurring task automatically creates the next instance due date
Set Up Overdue Notifications

Maintenance tasks can trigger alerts when they become overdue. Configure notification preferences in Settings → Notifications to receive in-app or push notifications for maintenance_overdue events.

Dashboard Widget​

The Dashboard shows a maintenance widget with:

  • Upcoming tasks (due within 7 days) with progress bars showing % of interval used
  • Overdue tasks highlighted with a red badge and count
  • Quick-complete button for each overdue task

Printer Care Counters​

The printer detail panel shows care counters:

CounterDescription
Total Print HoursCumulative hours the printer has been actively printing
Prints Since Last MaintenanceJob count since the most recent maintenance log entry

These counters update in real time as jobs complete.

Nozzle Lifecycle Tracking​

Track nozzle installs and retirements per printer.

Installing a Nozzle​

  1. Open the printer detail panel
  2. Click the Nozzle tab
  3. Click Install New Nozzle
  4. Enter:
    • Nozzle type (hardened steel, brass, ruby, etc.)
    • Nozzle diameter (e.g., 0.4mm)
    • Optional install notes

Retiring a Nozzle​

  1. Open the Nozzle tab on the printer detail panel
  2. Click Retire on the current nozzle
  3. The nozzle's retirement timestamp and accumulated print hours are saved

Nozzle History​

All nozzle installs and retirements are retained indefinitely. The Nozzle tab shows:

  • Current nozzle (type, diameter, installed date, accumulated hours)
  • Full retirement history

Nozzle API​

EndpointMethodDescription
GET /api/printers/{id}/nozzlesGETList nozzle lifecycle records for a printer
POST /api/printers/{id}/nozzlesPOSTInstall a new nozzle
PATCH /api/printers/{id}/nozzles/{nozzle_id}PATCHUpdate nozzle record
DELETE /api/printers/{id}/nozzles/{nozzle_id}DELETEDelete a nozzle record (admin)

See Also​