Improve this doc

Application types

When you first create an application, in addition to selecting a Device Type, you may be asked to select an Application Type:

The type of an application defines the capabilities of the devices provisioned to that application and is tied closely to pricing plans.

New applications

The three available application types for new applications are:

Starter

Starter applications, available for free to all users, are full-featured, allowing you to run multiple containers and set up a public URL for each of your devices. You are limited to ten devices across all starter applications.

Microservices

Microservices applications, like starter applications, are full-featured, and are available to all paid plans.

Essentials

Essentials applications allow you to run a single container and do not permit public device URLs. Like microservices applications, they are only available to paid plans.

The prototype pricing plan includes 20 devices, in addition to the 10 starter devices included with all plans. The pilot plan includes 50, and the production plan includes 100. You can choose any combination of microservices and essentials devices within these limits. With the pilot and production plans, you can add additional devices at $1.50 for the microservices type, and $1 for the essentials type.

Note: All devices in starter, microservices, and essentials applications must run resinOS v2.12.0 or higher. If you do not have the option to choose one of these application types, the selected device type does not yet have a high enough resinOS version available. A classic application type will be assigned by default.

Classic and legacy applications

The classic and legacy application types allow for applications that don't meet the requirements for new applications. Classic applications support devices with resinOS v2.0.3 and above, and legacy applications support all earlier resinOS versions. Classic applications use Docker Registry V2, whereas legacy applications use the slower and less reliable Registry V1.

While it is possible to provision new devices to these applications, it is not possible to create new legacy applications, and new classic applications can only be created for device types that do not yet have resinOS v2.12.0 or higher available. It is important to note that you cannot run multiple containers with these application types. However, for supported device types, you can convert a classic or legacy application to a microservices or essentials application, as described below.

Convert between application types

Existing applications can be converted to any of the types available for new applications, as long as all devices belonging to that application meet the OS version requirements and the account has appropriate privileges. Users can convert any application to classic if they have an existing classic or legacy application, and to legacy if they have an existing legacy application.

To convert your application, first be sure all devices meet the resinOS version requirements for the desired application type, updating if necessary. Then, from the application summary page, click Actions, followed by Change Application Type. A dialog will appear with the available application types:

Select the application type you would like to convert to. If your application cannot be converted to the selected type, you will see an error message at the top of the Actions page.