Skip to main content

Active device is the public pricing word for a device, server, or runtime identity where Bitfield was actually asked to run during the billing window.

It does not mean “installed once forever.” It does not mean “authorized in theory.” It does not mean “how many seconds the runtime ran.” It means Bitfield was actually asked to run for that identity in the billing window.Active device is a pricing label over signed Bitfield observations. It is not a second billing system beside Runtime Kit, and it is not a special rule for local installs only.The technical line is simple: request bytes entered Bitfield, Bitfield decoded an envelope, and the address resolved to a slot, native handler, or live state. That identity can count. Static files being served do not cross that line.For local Bitfield, the identity starts from local device key material. Bitfield creates or reads this-device.key, derives a device public key hash, and uses an activation ID for that runtime. By default, the activation ID is the device public key hash.That means active device is not a cookie, browser tab, IP address, VPN address, or page view. It is the activated runtime identity.
Plan

Your plan includes a range of runtime/device units.

Request

A device, server, or runtime identity calls into Bitfield.

Manage

The account portal manages runtime identities you no longer want active.

What counts

Runtime identityCounts when
Laptop or desktopBitfield is asked to run there during the billing window.
Phone or tabletBitfield is asked to run there during the billing window.
Server, cloud runtime, or local boxBitfield is asked to run there during the billing window.
Test machine or CI runnerBitfield is asked to run there during the billing window.
Customer deviceThat customer environment asks Bitfield to run.

What does not count by itself

ThingWhy
Old installed filesDormant files send no Bitfield request bytes.
Public website visitorViewing already-published output sends no Bitfield envelope bytes.
Static exported pageVisitors reading static files do not resolve a Bitfield slot, native handler, or live-state read.
Same runtime doing lots of workUsage amount is not the unit.
Package folderA package is product material, not request bytes entering Bitfield.

Repeat use and split identities

SituationCount model
Same activated laptop, many actionsOne runtime/device unit for the billing window.
Same laptop, different browsers or incognitoStill one unit when they talk to the same local Bitfield runtime identity.
Same laptop, VPN on or offStill one unit. IP address is not the identity.
Same laptop, cookies clearedStill one unit when local Bitfield activation state remains.
Laptop plus phoneTwo units when both send Bitfield request bytes.
One activated server serving many visitorsOne server unit unless visitor browsers also send Bitfield request bytes.
Ten activated serversUp to ten server units.
Persistent CI runnerOne runner identity can count once for the window.
Fresh ephemeral CI runner every runEach newly activated runner can count separately.
Deleted activation state and activated againCan become a new identity. Revoke old identities from the account portal.

Local activation state

Runtime Kit package state and engine storage live under ~/.bitfield/, and activation has its own sibling lane for this device’s signed permission. That local state is not something the customer should edit by hand.
Local ideaCustomer rule
Device key materialCreated by the activation flow, not invented manually
Signed permissionComes from account-owned activation
Old blocked permissionsRemembered so revoked access does not silently return
Runtime Kit package stateSeparate from activation; do not mix the two

Common failures

SymptomLikely causeFix
New computer cannot run BitfieldDevice path was not activated yetUse the account portal activation flow
Old computer still appears activeRuntime identity was not revoked or replacedManage active devices in the account portal
User copies one device’s local activation folder to anotherLocal permission was treated like a portable keyActivate the second runtime identity properly
Package tooling tries to own activationRuntime Kit and activation boundaries got mixedKeep activation in the account/key lane
Billing is explained as runtime secondsRuntime request count and runtime amount were mixed upSay one identity where Bitfield was asked to run, not per second

Verify

The active-device model is clear when the user can tell the difference between:
  • the plan subscription
  • a runtime/device unit that sent Bitfield request bytes
  • local activation state
  • Runtime Kit package state
  • public static traffic

Next

Manage runtime identities from account.bitfield.so. For concrete billing examples, read What you pay for. For product rollout, read Device and deployment shape, then Plan changes and cancellation.
Last modified on May 11, 2026