GuidesRecipesAPI ReferenceChangelogDiscussions
Log In


Device Groups

Before deploying an instance of Modzy Edge to a remote device, you'll first need to create a Device Group.

A Device Group is a collection of configuration, Modzy models, registration tokens, and registered devices.
All devices registered under a particular Device Group will inherit that Device Group's configuration, and be predisposed to download and run the models associated with the Device Group upon startup.


There are a number of configuration options available to you when creating your Device Group. Some values can be omitted completely, while others are only necessary in certain use cases. The table below describes the available configuration options.

Configuration FieldDescriptionDefaultRequired
data-dirModzy Edge will need to store some information on the local disk. This specifies that path in which to do so~/.modzy or /opt/modzyFalse
runtimeThe container runtime utilized for running the model containersDockerTrue
model.registry.hostHostname of the container registry from which to pull model image containers fromN/A
model.registry.portThe port that registry is listening on443
modzy.registry.credentialsCredentials necessary for pulling images from the specified registryN/A
modzy.registry.skipTLSVerifyWhether or not to skip the TLS verification step when connecting to the model registryFalse
storage.driverModzy Edge will store job data and results using the specified storage driver. Avaialble options are:
Local Filesystem
* Remote DB

[Only Local is implemented]
N/A -- we should make it filesystem tho?True
storage.filesystem.pathThe directory on the local filesystem to save job data~/.modzy or /opt/modzyTrue if your storage.driver = filesystem
storage.s3.regionThe region in which your S3 bucket residesN/ATrue if your storage.driver = S3
storage.s3.bucket-nameThe name of the S3 bucket used to save job dataN/ATrue if your storage.driver = S3
storage.s3.access-keyThe access key for your S3 bucketN/ATrue if your storage.driver = S3
storage.s3.access-key-secretThe secret access key for your bucketN/ATrue if your storage.driver = S3
storage.s3.pathThe path in the S3 bucket where job data will be savedN/ATrue if your storage.driver = S3


You'll need to select at least one model from your Model Library to associate with your Device Group. Nothing changes when discussing models in the context of a Device Group -- these are the same models available to you in your Modzy Enterprise installation and work exactly the same.

When Modzy Edge boots up on your device, it will inspect the local container image registry on that device for the model images . If the model image(s) is found, then Modzy Edge will launch the container on startup. In the case that the images are not present in the local registry, then Modzy Edge will connect to the specified container registry and pull the necessary image before starting the model container.

When it comes to which model is deployed, it's an all or nothing situation. Modzy Edge will run all models associated with the Device Group on the host device, so it's important to add only the models you'll need to run on the devices associated with the Device Group.

The Registration Token is exchanged between Modzy Edge, and the enterprise installation of Modzy that launched it. This handshake establishes the validity of the deployment, ensuring that the deployment on a device came from a valid Device Group from a valid enterprise installation of Modzy.