Gogo Shell Commands

The Gogo shell executes Felix Gogo basic commands and Liferay commands. The Gogo shell is accessible in the Control Panel (recommended) and from the command line.

Here are some commonly used commands:




Lists information about a specific bundle including the bundle’s symbolic name, bundle ID, data root, registered (provided) and used services, imported and exported packages, and more

diag [BUNDLE_ID]

Lists information about why the specified bundle is not working (e.g., unresolved dependencies, etc.)

dm na

Lists OSGi components that are “not available” (unresolved). Please see Leveraging the Shell for more Dependency Manager information.


Lists all unsatisfied Declarative Services (DS) components

ds:unsatisfied [BUNDLE_ID]

Lists the bundle’s unsatisfied DS components

headers [BUNDLE_ID]

Lists metadata about the bundle from the bundle’s MANIFEST.MF file

equinox:refresh [BUNDLE_ID]

Detects available optional dependencies and reactivates the bundle.


Lists all the available Gogo shell commands. Notice that each command has two parts to its name, separated by a colon. For example, the full name of the help command is felix:help. The first part is the command scope while the second part is the command function. The scope allows commands with the same name to be disambiguated. E.g., scope allows the felix:refresh command to be distinguished from the equinox:refresh command.


Lists information about a specific command including a description of the command, the scope of the command, and information about any flags or parameters that can be supplied when invoking the command.

inspect capability service [BUNDLE_ID]

Lists services exposed by a bundle

install [PATH_TO_JAR_FILE]

Installs the specified bundle into Liferay’s module framework


Lists all of the bundles installed in Liferay’s module framework. Use the -s flag to list the bundles using the bundles’ symbolic names.

packages [PACKAGE_NAME]

Lists all of the named package’s dependencies


Lists all of the components registered in the module framework (scr stands for service component runtime)


Lists information about a specific component including the component’s description, services, properties, configuration, references, and more.


Lists all of the services that have been registered in the module framework

start [BUNDLE_ID]

Starts the specified bundle

stop [BUNDLE_ID]

Stops the specified bundle


Scans the system for anomalies, executing the ds:unsatisfied and dm na commands.

uninstall [BUNDLE_ID]

uninstalls the specified bundle from the module framework. This does not remove the specified bundle from Liferay’s module framework; it’s hidden from Gogo’s lb command, but is still present. Adding a new version of the uninstalled bundle, therefore, will not reinstall it; it will update the currently hidden uninstalled version. To remove a bundle from Liferay’s module framework permanently, manually delete it from the [Liferay Home]/osgi folder. For more information on the uninstall command, see OSGi’s uninstall documentation.

Additional Information