the apiary
Download
honeycomb docs
GitHub Community latest

Getting started with Hive

Open the portal, read the health rail, and find your way around. Written for anyone.

Getting started with Hive

Open the portal, read the health rail, and find your way around. Written for anyone.

Related:

#1. Install the Apiary

Hive comes up as part of the Apiary. One command installs the whole stack and brings the portal up at 127.0.0.1:3853.

macOS or Linux

curl -fsSL https://get.theapiary.sh | sh

Windows (PowerShell)

irm https://get.theapiary.sh/install.ps1 | iex

#2. Open the portal

Go to http://127.0.0.1:3853 in your browser and bookmark it. That is the only address you need.

If the stack is still coming up, you land on the readiness screen, one tile per service. It dismisses itself the moment everything is ready and drops you into the dashboard. You never see a broken page.

#3. Read the health rail

A status pill for each service sits at the top of every page. The shapes read without color:

  • an empty honeycomb cell means the service is starting
  • a bee settling in means it just came up and is warming
  • a bee with wide wings means it is active and healthy
  • a one-winged bee with a caution mark means it is up but not fully healthy
  • a bee on its back means it failed or is unreachable and likely needs attention

#4. Find your way around

The dashboard covers the whole stack:

  • memories and projects
  • the memory graph and the code graph
  • sync activity and logs
  • ROI, which nets your savings against running cost
  • settings

#5. When a panel goes quiet

If a panel says "unreachable," the service that owns it is not answering right now. Doctor restarts crashed services on its own, and the panel recovers once the service is back. The health page shows which service and since when, with a live log tail you can turn up or down.

#What next