Soralets & Modules

Creating a Soralet

To upload a WASM module, you must first create a Soralet. A Soralet is a WASM runtime container on Soracom which will run your WASM modules, and which can contain multiple versions of of your modules.

  1. Login to the User Console. From the Menu, open the Soralet Management screen.

  2. Click the New button.

    https://console.soracom.io

    Soralet Management screen

  3. Enter a unique Soralet ID for your Soralet.

    Create a new Soralet

    The name of a Soralet can only consist of numbers, letters, underscores, and hyphens, and must be 100 characters or less.

    Then click Create Soralet.

Your Soralet will appear in the list of Soralets.


Uploading a Module

Now, upload your WASM module to your Soralet:

  1. Click the ID of the Soralet you want to configure.

    https://console.soracom.io

    Select Soralet

  2. From the Versions tab, click the Upload new WASM button.

    https://console.soracom.io

    Upload WASM module

  3. Select the compiled WASM module file, then click Upload.

    Select module to upload

Once uploaded, your module will appear in the list of versions.

https://console.soracom.io

Soralet module versions

You can then follow the Device Testing documentation to test your module in on Soracom, and the Configuration documentation to enable your module for a device group.

If you upload additional modules to the same Soralet, they will be saved separately rather than overwriting existing modules. Each time you upload another WASM module, the Soracom Resource Name (SRN) version number will automatically increment. This allows you to easily update your group configuration and roll back to a previous version without re-uploading an older WASM module.


Deleting a Module

If you no longer need a particular module version, or if you have reached the limit of modules that can be uploaded to a Soralet, you can delete individual modules.

  1. Click the ID of the Soralet you want to configure.

  2. From the Versions tab, click the button for the module version you want to delete.

    https://console.soracom.io

    Delete module

    You can only delete a module if it is not used in a group configuration.

    Deleting a module is a permanent action. Once deleted, a module cannot be restored. You will need to upload the module again.


Deleting a Soralet

Once you have deleted all modules from a Soralet, you can also delete the Soralet itself:

  1. Click the ID of the Soralet you want to configure.

  2. Click the Delete button.

    https://console.soracom.io

    Delete Soralet


Programmatic Usage

You can also create and manage Soralets using the Soracom API and Soracom CLI. In many cases, you may prefer configuring Soralets programmatically as part of your Orbit module development process, in order to avoid using the User Console interface. For more information on deploying Orbit modules programmatically, refer to the Deployment documentation.