Appearance

Migration to v2 ​

This guide highlights the major platform changes introduced with the latest release of Printercow and outlines how to adapt existing deployments. Each section lists what changed, the impact on operators, and the recommended actions when upgrading from previous versions.

URL Updates ​

  • User console: app.printercow.com → console.printercow.com
  • API base: app.printercow.com/api → api.printercow.com

Migration actions

  • Update saved bookmarks, documentation references, and any reverse proxies or allowlists that point to the old hostnames.
  • Adjust OAuth redirect URIs, webhook targets, or third-party integrations to use the new domains.

API Changes ​

  • New base URL: https://api.printercow.com
  • Heartbeat support added to existing device endpoints.
  • Request and response schemas remain backward compatible aside from new heartbeat fields.

Migration actions

  • Update API clients to target the new base URL.
  • Ensure firewall rules allow outbound traffic to api.printercow.com.
  • Review heartbeat handling if your tooling filters device events.

Device Communication Protocol ​

  • Communication moved from WebSockets to MQTT with mutual TLS certificates.
  • Provides higher throughput, better scalability, and improved security.

Migration actions

  • Flash the latest Printercow software on MicroSD cards.

Authentication ​

  • Clerk has been removed in favor of Printercow native authentication.
  • Simplifies future open-source packaging and removes external identity dependencies.

Migration actions

  • Create a new account on console.printercow.com if you don't have one already.

In-App Shop ​

  • A built-in shop now allows purchasing preinstalled SD cards, printer bundles, and ready-to-print kits.

Migration actions

  • No changes required.

Billing Enhancements ​

  • Billing section is now active to manage credits and purchase additional allocations.

Migration actions

  • Ensure finance teams know invoices and credit history are accessible under Billing in the console.
  • Review usage alerts related to credits to avoid unintended service interruptions.

Printer Telemetry ​

  • Telemetry now includes Wi-Fi SSID, signal strength, device uptime, and additional health metrics.

Migration actions

  • Update monitoring dashboards to surface the richer telemetry data.
  • If you consume telemetry via heartbeat API endpoint, handle the new fields to avoid schema validation errors.

Remote Commands ​

  • Added remote upgrade command to flash new device software alongside expanded device command coverage.

Migration actions

  • No changes required.

Bug Fixes and Stability ​

  • Numerous fixes across the console, API, and device stack improve reliability.

Migration actions

  • Ensure all services are updated (console, API, device agents) to benefit from the stability improvements.