Step 1 - Get your custom API (check-in) URL

You will get this URL when you have registered and logged in.

Step 2 - Configure device to check-in (more walkthroughs soon!)

The device must connect to a simple web URL on a scheduled basis. That way we can monitor to see if it is still ok. It can optionally also POST some data to that URL, which will be available on your dashboard, and soon we'll be parsing some specific device data for other status info.

Have any given device run a GET as the following (curl is an example). Examples here are for a couple of different system types, but if you can get the device to connect to this URL on a schedule, it will show up on the dashboard.

# from Windows PowerShell
Invoke-WebRequest -Method GET -Uri "YOURURL"

# or from Windows task scheduler directly (without running an external script)
# with arguments (escape the & in the URL with a ` backtick. Becomes "userid=...`&deviceid=...")
Invoke-WebRequest -Method GET -Uri "YOURURL"

# getting creative, to send drive SMART status (ok/failed) as payload, using Windows wmic
Invoke-WebRequest -Method POST -Uri "YOURURL" -Body (wmic diskdrive get status)

# from a linux/bsd system (use the single quotes in the command line)
curl 'YOURURL'

# as a cron job (interval is up to you, but note min interval based on your account type)
*/5 * * * * curl -s 'YOURURL' > /dev/null

# as a cron job, example posting command output so can monitor things
*/15 * * * * /usr/sbin/smartctl -A /dev/sda | curl -s -X POST --data-binary @- 'YOURURL' > /dev/null
*/15 * * * * cat /proc/mdstat | curl -s -X POST --data-binary @- 'YOURURL' > /dev/null

Do not share your userid or custom URL. There is an adoption process for new api events with your userid and new DEVICEIDs.

Step 3 - Repeat

Add as many devices as your account type allows. They'll all show up on your devices page.

Step 4 - Turn on Notifications

Go to your user preferences page and turn on notifications. You'll get notifications if your devices stops checking-in. Notifications are currently throttled to a max of one per hour and only on a good-to-bad state change. More options later.


Keep watching. More to come! But this basic notification service should continue to work as is. We hope to make this a very reliable service to check for device health! Soon we'll be adding the ability to parse certain data (like drive health) to notify on more than check-in failures!