Skip to main content
Version: 5.31.0

Application Hosting - Management

Management and status of images and created applications can be found under app-hosting context under admin exec mode.

example:/#> app-hosting
example:/app-hosting/#>

[no] label <IMAGE> <LABEL>

Description

Set/change the label of an image. Labels are used to identify images when configuring apps.

IMPORTANT: the effect of changing a label is only applied after issuing a reload [LABEL] command.

If the label already exists on another image, it will be moved. After moving the label to a new image, the reload [LABEL] command should be used to update and restart any running apps.

Options

OptionDescription
IMAGE

The image to set a new label for. Needs to be an existing image on the system.

LABEL

The name of the label. Maximum 15 characters.

no

Removes the configured label for an image.

reload [LABEL]

Description

Update applications whose images match the label, and restart them. If no label is specified, all applications are updated and restarted. The effect of changing a label is only applied after a reload or reconfiguration. Useful if you have updated an existing image that you want to deploy to all applications using the old image.

Options

OptionDescription
LABEL

The label of an image you want to reload. All applications configured with this label are restarted.

attach <APP>

Description

Attach to running application. Run exit or press ctrl-d to detach.

Options

OptionDescription
APP

Name of the application you want to attach to.

start <APP>

Description

Start a stopped application.

Options

OptionDescription
APP

Name of the application you want to start.

stop <APP>

Description

Stop a running application.

Options

OptionDescription
APP

Name of the application you want to stop.

restart <APP>

Description

Restart a running application.

Options

OptionDescription
APP

Name of the application you want to restart.

show log <APP>

Description

Show generated logs for an application.

Options

OptionDescription
APP

Name of the application you want to view logs for.

follow log <APP>

Description

Follow generated logs for an application.

Options

OptionDescription
APP

Name of the application you want to follow logs for.

show [app [APP]]

Description

Show a summary of application hosting.

Options

OptionDescription
app [APP]

Show summary of all enabled applications or the details of one application.

WeOS upgrade​

It is strongly recommended to stop all applications before launching upgrade of WeOS. This is to allow smooth upgrade of the system and avoid out-of-memory issues, since applications altogether might consume up to 50% of system RAM.

HowTo Guide​

For detailed instructions on how to enable the feature, import images, and run applications, refer to: