Enroll onto a Mesh¶
If a VeeaHub is not enrolled, it is not visible to any users in the Veea cloud — it is essentially invisible and unmanaged.
When you enroll a VeeaHub, you either:
- Create a new mesh network containing just that VeeaHub, which implicitly makes it the network gateway (the "Mesh Edge Node" or MEN), or
- Add the VeeaHub to an existing mesh network, which implicitly makes it a simple node on the mesh (a "Mesh Node" or MN).
The access controls for the VeeaHub in the Veea cloud come from the mesh it is enrolled onto.
Note
You do not need to enroll the VeeaHub using the same Veea account that registered it, although that is the typical workflow.
Enroll onto a New Mesh¶
A mesh name can include the characters A-Z, a-z, 0-9, _, and -, and can be up to 32 characters long.
The command automatically attempts to use a public geolocation service to determine the country and region where the VeeaHub is located. If this fails, or you wish to override it, provide a country and timezone explicitly:
- The country code is an ISO 3166-1 alpha-2 code.
- The timezone is an IANA TZ identifier.
As with all cloud operations, you are prompted to authenticate with a URL and authorization code.
Enroll onto an Existing Mesh¶
First list the meshes available to you:
Then provide the UUID of the chosen mesh:
Wait for Bootstrap¶
Once the VeeaHub is enrolled, it retrieves its configuration via bootstrap, completes initialisation, starts up, and becomes fully operational.
Allow up to 10 minutes
The bootstrap code includes a backoff-and-retry algorithm, so it may take up to 10 minutes before the VeeaHub retrieves its configuration and comes into service.
Verify with:
When complete, the output ends with Hub is fully operational True. See Check Status for the full field reference.
Unenroll¶
Unenrolling a VeeaHub removes it from a mesh and puts it back into the "Bootstrapping" state. Unenroll from the Veea cloud, or run:
You can only unenroll a VeeaHub if you have administration privileges on the mesh it is enrolled on.