LaunchCanvas Portal

Quickstart: from a device list to a live wall

About ten minutes, start to finish, once the apps are running.

Before you start: this guide assumes the suite is installed and running on this host - either via the one-shot setup script or each app's own docker compose up (see the apps for ports and links). Pick the path that matches where you're starting from; both end at the same wall.

Path A - you have devices, but no diagram

Let SNMP do the drawing prep for you: monitor first, and a starter diagram falls out of it.

  1. SNMPCanvas - open Devices and Add (or Bulk add for a subnet's worth at once). Enter each device's address and SNMP credentials - the probe shows what the device offers before anything is saved.
  2. On each device, check Export for the interfaces and sensors you want visible on the wall. Every exported value gets a short {code} token - you'll paste those into the diagram in step 5. (Devices themselves report up/down automatically.)
  3. In Settings → Inventory export, click Export inventory (CrossCanvas CSV). The download lists every monitored device with its address, serial, and a best-guess stencil - routers arrive as routers, switches as switches.
  4. CrossCanvas - File → Import Inventory, pick the CSV. Your fleet lands on the canvas labeled and icon'd. Lay it out, draw the connections, add zones - make it yours.
  5. Where you want a live reading on the wall, put its {code} token in a label or annotation - Rx {Xa3} next to an uplink, for example. Plain text stays plain; tokens become numbers.
  6. Save the diagram as an .xcanvas file (any name is fine).
  7. LaunchCanvas - back on the Launch page, use Wall board → Upload board. The file lands (as board.xcanvas) exactly where the kiosk reads it, and the previous board is kept as a one-click backup.
  8. PingCanvas - open the kiosk tile. Devices colored by reachability, your {code} tokens showing live readings, refreshing on its own. Put it on the wall TV and enjoy.

Path B - you already have a diagram

  1. CrossCanvas - File → Import Diagram brings in Visio (.vsdx), draw.io, or Gliffy files; stencils are matched to the suite's own icon set.
  2. Give each device you want monitored an IP-Address in its Device Details - that single field is what makes it a monitored device on the wall. Devices without one stay decorative, which is sometimes exactly right.
  3. Want live readings too, not just up/down? Add the same devices in SNMPCanvas, check Export on the values you care about, and put their {code} tokens into labels or annotations on the diagram.
  4. Continue from step 6 above: save, upload, open the kiosk.

Where you end up

A PingCanvas wall: the diagram with live status colors and readings

From here, the rest of the suite is one step each:

  • AlertCanvas - set thresholds on the exported values (CPU over 90, temperature over 45, device down) and get email, ntfy, or syslog notifications. It watches the same feed the wall does.
  • SyslogCanvas - point your devices' syslog and SNMP traps at this host (514/udp and 162/udp) and you have a searchable record of what everything said, for the day the wall shows red.
  • Single sign-on - set one shared SUITE_SECRET across the suite and logging in here logs you into every app at once (the LaunchCanvas README has the two-line recipe).