Skip to content

TIP

This document is applicable to version 1.14.x, Please use the command ll-cli --version to check your linyaps program version.


Manage Applications with the CLI ​

This chapter assumes that you have completed the Quick Start and can use search, install, and run to search for, install, and run applications. It covers two areas:

  • Managing installed applications, including inspecting, upgrading, and uninstalling them.
  • Managing running applications, including inspecting and stopping them.

Manage Installed Applications ​

Install a Specific Application Version ​

First, query all versions available in the repository:

bash
ll-cli search org.deepin.calculator --show-all-version

Append a version to the application ID to install that version:

bash
ll-cli install org.deepin.calculator/6.5.26.1

See ll-cli search and ll-cli install for all options.

List Installed Applications ​

Use the following command if you have forgotten an application ID, need to confirm that an application is installed, or want to check the installed version:

bash
ll-cli list

To show only applications that can be upgraded:

bash
ll-cli list --upgradable

You can also filter the results by App, Runtime, or Base. See ll-cli list for all options.

Upgrade Applications ​

Upgrade all installed applications:

bash
ll-cli upgrade

Upgrade one application:

bash
ll-cli upgrade org.deepin.calculator

See ll-cli upgrade for all options.

Uninstall an Application ​

bash
ll-cli uninstall org.deepin.calculator

See ll-cli uninstall for all options.

Manage Running Applications ​

List Running Applications ​

Use the following command to check whether an application is still running or to diagnose duplicate launches and processes that remain after their windows disappear:

bash
ll-cli ps

The output includes the application ID, container ID, and process ID. See ll-cli ps for all options.

Stop a Running Application ​

If an application is unresponsive, cannot exit normally, or must be stopped before an upgrade, first confirm its ID with ll-cli ps, then run:

bash
ll-cli kill org.deepin.calculator

This sends SIGTERM by default. If the application still does not exit, send signal 9 (SIGKILL) to terminate it forcibly:

bash
ll-cli kill -s 9 org.deepin.calculator

Forced termination does not give the application an opportunity to save data or clean up resources and can cause unsaved data to be lost. Use it only when a normal kill does not work. See ll-cli kill for all options.

View Command Help ​

When you are unsure which subcommands or options are available, use --help. To view the global options and subcommand list for ll-cli:

bash
ll-cli --help

Place --help after a subcommand to view its options and usage. For example:

bash
ll-cli install --help

Other subcommands work the same way:

bash
ll-cli run --help
ll-cli list --help
ll-cli kill --help

If the regular help hides advanced options, use --help-all:

bash
ll-cli --help-all
ll-cli run --help-all

Continue Reading ​

  • The ll-cli Command Reference lists every subcommand and its detailed usage.
  • Manage Runtimes with the CLI covers dependency and disk-usage analysis, removal of unused runtimes, and forced operations.
  • The FAQ covers common issues involving application execution, data directories, desktop integration, and dependencies.
  • When diagnosing a problem, add --verbose after the command to obtain detailed logs. Provide the community with the complete command, logs, system version, and output of ll-cli --version.