Directory Structure of WSO2 Products

All WSO2 products are built on top of the Carbon platform. The directory structure described below is the structure that is inherited by all Carbon-based WSO2 products. However, note that each product may contain folders and files that are specific to the product, in addition to what is described below.


<PRODUCT_HOME> refers to the root folder of the WSO2 product distribution. <PROFILE_HOME> refers to the root directory of other profiles that are shipped as separate runtimes with a product.

Folder Description General Folder Path Folder Path for Profiles
bin Contains various scripts ( .sh & .bat scripts). <PRODUCT_HOME>/bin/ <PRODUCT_HOME>/wso2/<PROFILE_HOME>/bin/
database Contains the databases. <PRODUCT_HOME>/repository/database/ <PRODUCT_HOME>/wso2/<PROFILE_HOME>/repository/database/
dbscripts Contains all the database scripts. <PRODUCT_HOME>/dbscripts/ <PRODUCT_HOME>/wso2/<PROFILE_HOME>/dbscripts/
lib Contains the basic set of libraries required for starting a WSO2 product in standalone mode. <PRODUCT_HOME>/lib/ <PRODUCT_HOME>/wso2/lib/
repository The repository where services and modules deployed in a WSO2 product are stored. In addition to this, the repository/components directory contains the Carbon runtime and JAR files added by users (such as third party libraries). <PRODUCT_HOME>/repository/ <PRODUCT_HOME>/wso2/<PROFILE_HOME>/repository/
conf Contains configuration files. <PRODUCT_HOME>/repository/conf/ <PRODUCT_HOME>/wso2/<PROFILE_HOME>/conf/
components Contains different components (OSGI bundles, features etc.) that are related to the product. <PRODUCT_HOME>/repository/components/ <PRODUCT_HOME>/wso2/components/
plugins Contains plugins that are related to the product. <PRODUCT_HOME>/repository/components/plugins/ <PRODUCT_HOME>/wso2/components/plugins/
patches Contains patches that are issues with the product. <PRODUCT_HOME>/patches/ <PRODUCT_HOME>/patches/
logs Contains all log files created during execution. <PRODUCT_HOME>/repository/logs/ <PRODUCT_HOME>/repository/logs/
resources Contains additional resources that may be required, including sample configurations and sample resources. <PRODUCT_HOME>/resources/ <PRODUCT_HOME>/wso2/<PROFILE_HOME>/wso2/resources/
samples Contains sample services and client applications to demonstrate the functionality and capabilities of WSO2 products. <PRODUCT_HOME>/samples/ <PRODUCT_HOME>/samples/<PROFILE_HOME>/
tmp Used for storing temporary files,and is pointed to by the .tmpdir system property. <PRODUCT_HOME>/tmp/ <PRODUCT_HOME>/wso2/<PROFILE_HOME>/tmp/
LICENSE.txt Apache License 2.0 and other relevant licenses under which the WSO2 product is distributed. <PRODUCT_HOME>/LICENSE.txt N/A
README.txt This document. <PRODUCT_HOME>/README.txt N/A
release-notes.html Release information for the WSO2 product. <PRODUCT_HOME>/release-notes.html N/A
wso2 Contains the directories of other profiles that are shipped as separate runtimes. <PRODUCT_HOME>/wso2/ N/A