When you create an application, in addition to selecting a Device Type, you must select an Application Type:
The type of application defines the capabilities of the devices provisioned to that application and is tied closely to the pricing plans.
The three available application types for new applications are:
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.
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 devices, and the production plan includes 100 devices. 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 balenaOS 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 balenaOS 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 balenaOS v2.0.3 and above, and legacy applications support all earlier balenaOS 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 balenaOS 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 balenaOS 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.