Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

12.2. Manual Deployment

Overview
Copy link

You can manually deploy and undeploy bundles by issuing commands at the Red Hat JBoss Fuse console.

Installing a bundle
Copy link

Use the osgi:install command to install one or more bundles in the OSGi container. This command has the following syntax: 
osgi:install [-s] [--start] [--help] UrlList
Copy to Clipboard Toggle word wrap
Where UrlList is a whitespace-separated list of URLs that specify the location of each bundle to deploy. The following command arguments are supported:
-s
Start the bundle after installing.
--start
Same as -s.
--help
Show and explain the command syntax.
For example, to install and start the bundle, ProjectDir/target/foo-1.0-SNAPSHOT.jar, enter the following command at the Karaf console prompt: 
osgi:install -s file:ProjectDir/target/foo-1.0-SNAPSHOT.jar
Copy to Clipboard Toggle word wrap
Note
On Windows platforms, you must be careful to use the correct syntax for the file URL in this command. See Section A.1, “File URL Handler” for details.

Uninstalling a bundle
Copy link

To uninstall a bundle, you must first obtain its bundle ID using the osgi:list command. You can then uninstall the bundle using the osgi:uninstall command (which takes the bundle ID as its argument).
For example, if you have already installed the bundle named A Camel OSGi Service Unit, entering osgi:list at the console prompt might produce output like the following: 
...
[ 175] [Active     ] [            ] [Started] [   60] ServiceMix :: FTP (2009.02.0.psc-01-00RC1)
[ 181] [Resolved   ] [            ] [       ] [   60] A Camel OSGi Service Unit (1.0.0.SNAPSHOT)
Copy to Clipboard Toggle word wrap
You can now uninstall the bundle with the ID, 181, by entering the following console command: 
osgi:uninstall 181
Copy to Clipboard Toggle word wrap

URL schemes for locating bundles
Copy link

When specifying the location URL to the osgi:install command, you can use any of the URL schemes supported by Red Hat JBoss Fuse, which includes the following scheme types:
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat