Select Page

OSGi-Bundle with the Maven-Bundle-Plugin

OSGi-Bundle with the Maven-Bundle-Plugin

OSGi (Open Service Gateway Initiative) is a #Java framework for developing and deploying modular software programs and libraries.OSGi has two parts. The first part is a specification for modular components called bundles, which are commonly referred to as plug-ins. The specification defines an infrastructure for a bundle’s life cycle and determines how bundles will interact.  The second part of OSGi is a #Java Virtual Machine (JVM)-level service registry that bundles can use to publish, discover and bind to services in a service-oriented architecture (SOA).

In this small post, I will show you how to make your first OSGi bundle using the Bundle Plugin for #Maven from Apache Felix

Create a new Eclipse project name osgitest with the standard structure and create a new Java file in src/main/java/

package com.waltercedric.osgi; 
import org.osgi.framework.BundleActivator;
import org.osgi.framework.BundleContext; 

public class Activator implements BundleActivator { 

public void start( BundleContext context ) throws Exception { System.out.println(
  context.getBundle().getSymbolicName() + " has started" ); 

public void stop( BundleContext context ) throws Exception 
 System.out.println(context.getBundle().getSymbolicName() + " is stopped" ); } 

Now add to the pom.xml the configuration example for the maven-bundle-plugin


The documentation of the maven plugin of Apache Felix is located at

You need a OSGi runtime, you can use the one shipped by Eclipse in Equinox (search for files  org.eclipse.osgi* on your disk )or download this one from Maven Central: org.eclipse.osgi-3.6.2.R36x_v20110210.jar

Now run in a command line or better in a Maven Shell

mvn package  java -jar org.eclipse.osgi_3.6.2.R36x_v20110210.jar -console -clean

Now lets install and start  our OSGI bundle

osgi> install file:target\osgitest-0.1.0-SNAPSHOT.jar start Bundle id is 1 com.waltercedric.osgitest: has started osgi> ss    id   State    Bundle     0   ACTIVE   org.eclipse.osgi_3.6.2.R36x_v20110210     1   ACTIVE   com.waltercedric.osgitest_0.1.0.SNAPSHOT osgi> uninstall 1 com.waltercedric.osgitest: is stopped osgi> close


About The Author

Cédric Walter

I worked with various Insurances companies across Switzerland on online applications handling billion premium volumes. I love to continuously spark my creativity in many different and challenging open-source projects fueled by my great passion for innovation and blockchain technology.In my technical role as a senior software engineer and Blockchain consultant, I help to define and implement innovative solutions in the scope of both blockchain and traditional products, solutions, and services. I can support the full spectrum of software development activities, starting from analyzing ideas and business cases and up to the production deployment of the solutions.I'm the Founder and CEO of Disruptr GmbH.