# wso2/carbon-kernel architecture

> Architecture diagram of the GitHub repository wso2/carbon-kernel, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wso2/carbon-kernel
- Repository: https://github.com/wso2/carbon-kernel

## Overview

Carbon Kernel is a lightweight OSGi server runtime and development platform. Its main operational flow is a server operator launching the Carbon server, which starts the OSGi-based runtime; kernel services then support component startup ordering and runtime lifecycle management. Separate capabilities cover server monitoring and context access, bundle deployment, and developer tools and archetypes. The README documents these capabilities, but only selected source files were excerpted, so several subsystem relationships are documented at the README level rather than traced through implementation.

Main entry points: [`launcher/src/main/java/org/wso2/carbon/launcher/CarbonServer.java`](https://github.com/wso2/carbon-kernel/blob/master/launcher/src/main/java/org/wso2/carbon/launcher/CarbonServer.java) (Carbon server), [`tools/tools-core/src/main/java/org/wso2/carbon/tools/CarbonTool.java`](https://github.com/wso2/carbon-kernel/blob/master/tools/tools-core/src/main/java/org/wso2/carbon/tools/CarbonTool.java) (Carbon tool API), [`core/src/main/java/org/wso2/carbon/kernel/internal/startupresolver/StartupComponentManager.java`](https://github.com/wso2/carbon-kernel/blob/master/core/src/main/java/org/wso2/carbon/kernel/internal/startupresolver/StartupComponentManager.java) (Startup resolver), [`launcher/src/main/java/org/wso2/carbon/launcher/Main.java`](https://github.com/wso2/carbon-kernel/blob/master/launcher/src/main/java/org/wso2/carbon/launcher/Main.java) (Server launcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_launch["Launch and deployment"]
  node_launcher["Server launcher<br/>[Main.java]"]
  node_server["Carbon server<br/>[CarbonServer.java]"]
  node_bundle_deployer["OSGi lib deployer"]
end

subgraph group_kernel["Kernel services"]
  node_startup_resolver["Startup resolver"]
  node_capability_model["Capability model<br/>[Capability.java]"]
  node_osgi_capability["OSGi service capability"]
  node_startup_api["Capability listeners"]
  node_context["Carbon context<br/>[CarbonContext.java]"]
  node_configuration["Kernel configuration"]
end

subgraph group_operations["Runtime operations"]
  node_runtime_api["Runtime API<br/>[Runtime.java]"]
  node_runtime_service["Runtime management"]
  node_runtime_manager["Runtime registry"]
  node_jmx["JMX monitoring"]
  node_logging["Server logging<br/>[Main.java]"]
end

subgraph group_development["Developer tools"]
  node_tool_api["Carbon tool API<br/>[CarbonTool.java]"]
  node_jar_converter["Bundle converter"]
  node_jar_installer["JAR installer"]
  node_osgi_tool["OSGi lib tool"]
  node_native_tool["Native library tool"]
  node_archetypes["Project archetypes"]
  node_test_container["In-container testing"]
end

node_operator(("Server operator"))

node_operator -->|"starts"| node_launcher
node_launcher -->|"launches"| node_server
node_startup_resolver -->|"tracks capabilities"| node_capability_model
node_startup_resolver -->|"records service needs"| node_osgi_capability
node_startup_resolver -->|"registers listeners"| node_startup_api
node_runtime_service -->|"gets runtimes"| node_runtime_manager
node_runtime_service -->|"controls runtimes"| node_runtime_api
node_bundle_deployer -->|"updates bundle data"| node_server
node_launcher -->|"configures logging"| node_logging
node_tool_api -->|"implemented by"| node_jar_converter
node_tool_api -->|"implemented by"| node_jar_installer
node_tool_api -->|"implemented by"| node_osgi_tool
node_tool_api -->|"implemented by"| node_native_tool
node_operator -.->|"uses API"| node_context
node_server -.->|"orders components"| node_startup_resolver
node_operator -.->|"manages runtimes"| node_runtime_service
node_operator -.->|"monitors server"| node_jmx
node_server -.->|"uses configuration"| node_configuration
node_server -.->|"loads bundles"| node_bundle_deployer
node_operator -.->|"converts JARs"| node_jar_converter
node_operator -.->|"creates projects"| node_archetypes
node_operator -.->|"tests in container"| node_test_container

click node_launcher "https://github.com/wso2/carbon-kernel/blob/master/launcher/src/main/java/org/wso2/carbon/launcher/Main.java"
click node_server "https://github.com/wso2/carbon-kernel/blob/master/launcher/src/main/java/org/wso2/carbon/launcher/CarbonServer.java"
click node_bundle_deployer "https://github.com/wso2/carbon-kernel/blob/master/launcher/src/main/java/org/wso2/carbon/launcher/extensions/OSGiLibBundleDeployer.java"
click node_startup_resolver "https://github.com/wso2/carbon-kernel/blob/master/core/src/main/java/org/wso2/carbon/kernel/internal/startupresolver/StartupComponentManager.java"
click node_capability_model "https://github.com/wso2/carbon-kernel/blob/master/core/src/main/java/org/wso2/carbon/kernel/internal/startupresolver/beans/Capability.java"
click node_osgi_capability "https://github.com/wso2/carbon-kernel/blob/master/core/src/main/java/org/wso2/carbon/kernel/internal/startupresolver/beans/OSGiServiceCapability.java"
click node_startup_api "https://github.com/wso2/carbon-kernel/blob/master/core/src/main/java/org/wso2/carbon/kernel/startupresolver/RequiredCapabilityListener.java"
click node_context "https://github.com/wso2/carbon-kernel/blob/master/core/src/main/java/org/wso2/carbon/kernel/context/CarbonContext.java"
click node_configuration "https://github.com/wso2/carbon-kernel/blob/master/core/src/main/java/org/wso2/carbon/kernel/config/model/CarbonConfiguration.java"
click node_runtime_api "https://github.com/wso2/carbon-kernel/blob/master/core/src/main/java/org/wso2/carbon/kernel/runtime/Runtime.java"
click node_runtime_service "https://github.com/wso2/carbon-kernel/blob/master/core/src/main/java/org/wso2/carbon/kernel/internal/runtime/CarbonRuntimeService.java"
click node_runtime_manager "https://github.com/wso2/carbon-kernel/blob/master/core/src/main/java/org/wso2/carbon/kernel/internal/runtime/RuntimeManager.java"
click node_jmx "https://github.com/wso2/carbon-kernel/blob/master/core/src/main/java/org/wso2/carbon/kernel/internal/jmx/CarbonJMXComponent.java"
click node_logging "https://github.com/wso2/carbon-kernel/blob/master/launcher/src/main/java/org/wso2/carbon/launcher/Main.java"
click node_tool_api "https://github.com/wso2/carbon-kernel/blob/master/tools/tools-core/src/main/java/org/wso2/carbon/tools/CarbonTool.java"
click node_jar_converter "https://github.com/wso2/carbon-kernel/blob/master/tools/tools-core/src/main/java/org/wso2/carbon/tools/converter/BundleGeneratorTool.java"
click node_jar_installer "https://github.com/wso2/carbon-kernel/blob/master/tools/tools-core/src/main/java/org/wso2/carbon/tools/InstallJarsTool.java"
click node_osgi_tool "https://github.com/wso2/carbon-kernel/blob/master/tools/tools-core/src/main/java/org/wso2/carbon/tools/osgilib/OSGiLibDeployerTool.java"
click node_native_tool "https://github.com/wso2/carbon-kernel/blob/master/tools/tools-core/src/main/java/org/wso2/carbon/tools/spi/NativeLibraryProvider.java"
click node_archetypes "https://github.com/wso2/carbon-kernel/tree/master/archetypes"
click node_test_container "https://github.com/wso2/carbon-kernel/blob/master/pax-exam-container-carbon/org.wso2.carbon.container/src/main/java/org/wso2/carbon/container/CarbonTestContainer.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_launcher,node_server,node_bundle_deployer toneBlue
class node_startup_resolver,node_capability_model,node_osgi_capability,node_startup_api,node_context,node_configuration toneAmber
class node_runtime_api,node_runtime_service,node_runtime_manager,node_jmx,node_logging,node_operator toneMint
class node_tool_api,node_jar_converter,node_jar_installer,node_osgi_tool,node_native_tool,node_archetypes,node_test_container toneRose
```

## Components

### Launch and deployment

- [Server launcher](https://github.com/wso2/carbon-kernel/blob/master/launcher/src/main/java/org/wso2/carbon/launcher/Main.java): `launcher/src/main/java/org/wso2/carbon/launcher/Main.java`
- [Carbon server](https://github.com/wso2/carbon-kernel/blob/master/launcher/src/main/java/org/wso2/carbon/launcher/CarbonServer.java): `launcher/src/main/java/org/wso2/carbon/launcher/CarbonServer.java`
- [OSGi lib deployer](https://github.com/wso2/carbon-kernel/blob/master/launcher/src/main/java/org/wso2/carbon/launcher/extensions/OSGiLibBundleDeployer.java): `launcher/src/main/java/org/wso2/carbon/launcher/extensions/OSGiLibBundleDeployer.java`

### Kernel services

- [Startup resolver](https://github.com/wso2/carbon-kernel/blob/master/core/src/main/java/org/wso2/carbon/kernel/internal/startupresolver/StartupComponentManager.java): `core/src/main/java/org/wso2/carbon/kernel/internal/startupresolver/StartupComponentManager.java`
- [Capability model](https://github.com/wso2/carbon-kernel/blob/master/core/src/main/java/org/wso2/carbon/kernel/internal/startupresolver/beans/Capability.java): `core/src/main/java/org/wso2/carbon/kernel/internal/startupresolver/beans/Capability.java`
- [OSGi service capability](https://github.com/wso2/carbon-kernel/blob/master/core/src/main/java/org/wso2/carbon/kernel/internal/startupresolver/beans/OSGiServiceCapability.java): `core/src/main/java/org/wso2/carbon/kernel/internal/startupresolver/beans/OSGiServiceCapability.java`
- [Capability listeners](https://github.com/wso2/carbon-kernel/blob/master/core/src/main/java/org/wso2/carbon/kernel/startupresolver/RequiredCapabilityListener.java): `core/src/main/java/org/wso2/carbon/kernel/startupresolver/RequiredCapabilityListener.java`
- [Carbon context](https://github.com/wso2/carbon-kernel/blob/master/core/src/main/java/org/wso2/carbon/kernel/context/CarbonContext.java): `core/src/main/java/org/wso2/carbon/kernel/context/CarbonContext.java`
- [Kernel configuration](https://github.com/wso2/carbon-kernel/blob/master/core/src/main/java/org/wso2/carbon/kernel/config/model/CarbonConfiguration.java): `core/src/main/java/org/wso2/carbon/kernel/config/model/CarbonConfiguration.java`

### Runtime operations

- [Runtime API](https://github.com/wso2/carbon-kernel/blob/master/core/src/main/java/org/wso2/carbon/kernel/runtime/Runtime.java): `core/src/main/java/org/wso2/carbon/kernel/runtime/Runtime.java`
- [Runtime management](https://github.com/wso2/carbon-kernel/blob/master/core/src/main/java/org/wso2/carbon/kernel/internal/runtime/CarbonRuntimeService.java): `core/src/main/java/org/wso2/carbon/kernel/internal/runtime/CarbonRuntimeService.java`
- [Runtime registry](https://github.com/wso2/carbon-kernel/blob/master/core/src/main/java/org/wso2/carbon/kernel/internal/runtime/RuntimeManager.java): `core/src/main/java/org/wso2/carbon/kernel/internal/runtime/RuntimeManager.java`
- [JMX monitoring](https://github.com/wso2/carbon-kernel/blob/master/core/src/main/java/org/wso2/carbon/kernel/internal/jmx/CarbonJMXComponent.java): `core/src/main/java/org/wso2/carbon/kernel/internal/jmx/CarbonJMXComponent.java`
- [Server logging](https://github.com/wso2/carbon-kernel/blob/master/launcher/src/main/java/org/wso2/carbon/launcher/Main.java): `launcher/src/main/java/org/wso2/carbon/launcher/Main.java`

### Developer tools

- [Carbon tool API](https://github.com/wso2/carbon-kernel/blob/master/tools/tools-core/src/main/java/org/wso2/carbon/tools/CarbonTool.java): `tools/tools-core/src/main/java/org/wso2/carbon/tools/CarbonTool.java`
- [Bundle converter](https://github.com/wso2/carbon-kernel/blob/master/tools/tools-core/src/main/java/org/wso2/carbon/tools/converter/BundleGeneratorTool.java): `tools/tools-core/src/main/java/org/wso2/carbon/tools/converter/BundleGeneratorTool.java`
- [JAR installer](https://github.com/wso2/carbon-kernel/blob/master/tools/tools-core/src/main/java/org/wso2/carbon/tools/InstallJarsTool.java): `tools/tools-core/src/main/java/org/wso2/carbon/tools/InstallJarsTool.java`
- [OSGi lib tool](https://github.com/wso2/carbon-kernel/blob/master/tools/tools-core/src/main/java/org/wso2/carbon/tools/osgilib/OSGiLibDeployerTool.java): `tools/tools-core/src/main/java/org/wso2/carbon/tools/osgilib/OSGiLibDeployerTool.java`
- [Native library tool](https://github.com/wso2/carbon-kernel/blob/master/tools/tools-core/src/main/java/org/wso2/carbon/tools/spi/NativeLibraryProvider.java): `tools/tools-core/src/main/java/org/wso2/carbon/tools/spi/NativeLibraryProvider.java`
- [Project archetypes](https://github.com/wso2/carbon-kernel/tree/master/archetypes): `archetypes`
- [In-container testing](https://github.com/wso2/carbon-kernel/blob/master/pax-exam-container-carbon/org.wso2.carbon.container/src/main/java/org/wso2/carbon/container/CarbonTestContainer.java): `pax-exam-container-carbon/org.wso2.carbon.container/src/main/java/org/wso2/carbon/container/CarbonTestContainer.java`

### Other components

- **Server operator**

## Connections

- Server operator → Server launcher: starts (evidence: `launcher/src/main/java/org/wso2/carbon/launcher/Main.java`)
- Server launcher → Carbon server: launches (evidence: `launcher/src/main/java/org/wso2/carbon/launcher/Main.java`)
- Startup resolver → Capability model: tracks capabilities (evidence: `core/src/main/java/org/wso2/carbon/kernel/internal/startupresolver/StartupComponentManager.java`)
- Startup resolver → OSGi service capability: records service needs (evidence: `core/src/main/java/org/wso2/carbon/kernel/internal/startupresolver/StartupComponentManager.java`)
- Startup resolver → Capability listeners: registers listeners (evidence: `core/src/main/java/org/wso2/carbon/kernel/internal/startupresolver/StartupComponentManager.java`)
- Runtime management → Runtime registry: gets runtimes (evidence: `core/src/main/java/org/wso2/carbon/kernel/internal/runtime/CarbonRuntimeService.java`)
- Runtime management → Runtime API: controls runtimes (evidence: `core/src/main/java/org/wso2/carbon/kernel/internal/runtime/CarbonRuntimeService.java`)
- OSGi lib deployer → Carbon server: updates bundle data (evidence: `launcher/src/main/java/org/wso2/carbon/launcher/extensions/OSGiLibBundleDeployer.java`)
- Server launcher → Server logging: configures logging (evidence: `launcher/src/main/java/org/wso2/carbon/launcher/Main.java`)
- Carbon tool API → Bundle converter: implemented by (evidence: `tools/tools-core/src/main/java/org/wso2/carbon/tools/converter/BundleGeneratorTool.java`)
- Carbon tool API → JAR installer: implemented by (evidence: `tools/tools-core/src/main/java/org/wso2/carbon/tools/InstallJarsTool.java`)
- Carbon tool API → OSGi lib tool: implemented by (evidence: `tools/tools-core/src/main/java/org/wso2/carbon/tools/osgilib/OSGiLibDeployerTool.java`)
- Carbon tool API → Native library tool: implemented by (evidence: `tools/tools-core/src/main/java/org/wso2/carbon/tools/spi/NativeLibraryProvider.java`)
- Server operator → Carbon context: uses API (evidence: `README.md`)
- Carbon server → Startup resolver: orders components (evidence: `README.md`)
- Server operator → Runtime management: manages runtimes (evidence: `README.md`)
- Server operator → JMX monitoring: monitors server (evidence: `README.md`)
- Carbon server → Kernel configuration: uses configuration (evidence: `README.md`)
- Carbon server → OSGi lib deployer: loads bundles (evidence: `README.md`)
- Server operator → Bundle converter: converts JARs (evidence: `README.md`)
- Server operator → Project archetypes: creates projects (evidence: `README.md`)
- Server operator → In-container testing: tests in container (evidence: `README.md`)
