Admission

Admission #

A tenant starts with a name, and the operator admitting it. That is the only thing the operator does for you; everything after it you do yourself.

Pick a name #

  • 1 to 8 characters, lowercase letters and digits, starting with a letter β€” ^[a-z][a-z0-9]{0,7}$
  • It becomes your DNS zone (<name>.mobile.deevnet.net), your MQTT topic prefix (<name>/…) and the name of your network. Pick something you will not mind seeing everywhere
  • sensors, bench1, ptv are fine; Pico-Demo and meetupproject are not

Ask the operator #

Tell the operator the name. They run one API call ( Tenant Admission) and hand you three things:

  1. an enrollment token (it looks like s.…)
  2. the API endpoint, https://api.mobile.deevnet.net:8080
  3. the site CA, site-ca.pem

What the token is #

Single useyour first terraform apply spends it, and hands you your own long-lived token in exchange
Bound to your namepresenting it for any other name spends it and fails with 401 β€” a typo costs a new admission
Expiresafter 72 hours. Admit close to when you will apply

Treat it like a password until it is spent. Once it is spent it is worthless, and from then on your credential is the tenant token in your Terraform state.

If the operator gets 409, the name is already taken β€” by someone else, or by you last time. A tenant that already exists does not need admitting again; it needs its own token.

Page last modified: September 26, 2026