Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.harbinge.rs/llms.txt

Use this file to discover all available pages before exploring further.

Follow this checklist in order. Each step unlocks the next.

​
Phase 1 — Account setup

1

Create your company account

Contact Forager support to provision your company account. A Hiverise Labs team member will set up your company in the system and send an admin invite to your email address.
2

Accept your admin invite

Look for an email with the subject “You have been invited”. Click the link inside — your account is verified automatically, no password needed at this step. You will land on a welcome page confirming you are in.You are now the account admin for your company. Log in to the dashboard at dashboard.hiveriselabs.com to continue setup.
If you ever need to log in on a new device after the invite link expires, use the Forgot Password flow on the login screen to set a password.
3

Invite your team

In the dashboard, go to Team and use the Invite Team Member card to send an email invite to each field technician. When they click the link in their email, they land on a welcome page with a direct link to download the Forager app from Google Play. They sign in with the email address the invite was sent to — no separate password setup required.

Team Management

Full guide: inviting members, changing roles, and removing users.
4

Assign techs to their sites

New team members have no site access until you assign them. In the dashboard, go to Sites and add each technician to the buildings they work in.A tech assigned to a building can see and confirm every asset inside it — all floors and rooms are included automatically. Techs not yet assigned to any site will see an empty screen in the app.If your team works out of a single building, assign everyone to that building. If you have multiple locations, assign each tech only to the buildings they cover.

Managing Sites

Full guide: assigning techs to buildings, multi-site access, and what techs see.

​
Phase 2 — Location hierarchy

1

Set up your location hierarchy

In the Forager app, navigate to Manage Locations. Build out your hierarchy from top to bottom:
  • Campus or site (optional)
  • Building
  • Floor
  • Room
You only need to create rooms you intend to track assets in. You can add more rooms at any time.
2

Upload floor plans (optional but recommended)

For each floor node, you can upload a floor plan image (JPEG or PNG recommended). This enables the visual floor plan view in the dashboard and helps techs navigate during Device Hunt.
PDFs are supported but interactive pins are not available for PDFs. Convert to JPEG or PNG for the best experience.
After uploading, tap each room’s pin icon to place it on the floor plan. This only needs to be done once.

​
Phase 3 — Survey

1

Run a survey of each room

Survey teaches Forager what each room looks like on the Wi-Fi and Bluetooth spectrum. Without survey, the app cannot determine which room a tech is currently in.For each room:
  1. Have a tech stand in the room with the Forager app open
  2. Open Survey Mode
  3. Select the floor and room
  4. Tap Capture — the app takes 4–6 RF scans over about 30 seconds
  5. Move to the next room and repeat
A full floor of 10–15 rooms typically takes 20–30 minutes.
2

Check coverage quality

After surveying, open Coverage in the app. Rooms show as:
  • Green — well surveyed, ready for attestation
  • Yellow — thin coverage, consider re-surveying
  • Gray — not yet surveyed
All rooms should be green before starting regular attestation work.

​
Phase 4 — First attestation

1

Scan your first asset

Have a tech stand in a surveyed room, open the Forager app, and scan an asset barcode. The app will:
  • Identify the current room from the RF fingerprint
  • Look up the asset’s recorded location
  • Confirm a match or flag a mismatch
  • Write an attestation record
That attestation record is now visible in the dashboard.
2

Verify in the dashboard

Log into the dashboard at dashboard.hiveriselabs.com. Open Floor Plan and select the floor where you just scanned. The room pin should show the asset count with a green indicator (confirmed within 7 days).

​
Phase 5 — CMDB integration (optional)

1

Seed your asset roster from CMDB

Rather than adding assets one by one, export a CSV from your CMDB (ServiceNow or equivalent) and upload it from the dashboard Assets page. Forager will create every asset in the file in seconds.The import accepts asset_tag, name, description, serial_number, cmdb_id, and cmdb_location. Only asset_tag is required. Re-importing is safe — existing records are updated, confirmed location data is never overwritten.

Assets — Import & Export

Learn how to bulk-import from CMDB and export the current roster as CSV.
2

Configure a webhook for ongoing sync (optional)

To push every attestation back to ServiceNow automatically, configure a webhook from the dashboard Settings → Webhooks page.

ServiceNow Integration Guide

Connect Forager to ServiceNow to push location updates to CI records automatically.