Consoles

When booting from the ISO, BurmillaOS starts with the default console, which is based on busybox.

You can select which console you want BurmillaOS to start with using the cloud-config.

Enabling Consoles using Cloud-Config

When launching BurmillaOS with a cloud-config file, you can select which console you want to use.

Currently, the list of available consoles are:

  • default (debian)

Here is an example cloud-config file that can be used to enable the debian console.

#cloud-config
rancher:
  console: debian

Listing Available Consoles

You can easily list the available consoles in BurmillaOS and what their status is with sudo ros console list.

$ sudo ros console list
current  default

Console persistence

The default console is persistent. Persistent console means that the console container will remain the same and preserves changes made to its filesystem across reboots. If a container is deleted/rebuilt, state in the console will be lost except what is in the persisted directories.

/home
/opt
/var/lib/docker
/var/lib/rancher

Note: When using a persistent console and in the current version’s console, rolling back is not supported. For example, rolling back to v0.4.5 when using a v0.5.0 persistent console is not supported.