The Ubuntu-based setup allows you to build the openUBMC environment natively using the toolchains and packages provided by the openUBMC project, combined with standard open-source tools.

Currently openUBMC only support Ubuntu 24.04 environment.

Preparing the Development Environment ​

1. Create a workspace directory and clone the manifest repository:

   shell

   mkdir workspace
   cd workspace
   git clone https://gitcode.com/openUBMC/manifest.git

2. Download the bmcsdk package from the openUBMC Community Software Marketplace. Place the downloaded bmc_sdk.zip file in the root of the cloned manifest directory.

   Then, run the initialization script. This script extracts and configures the required components (hpm_tools, rtos_compiler, sdk, and lua-format) from the SDK archive.

   shell

   cd manifest
   python3 init.py -path ./bmc_sdk.zip -user USER -psw PASSWORD

   Replace USER and PASSWORD with your openUBMC community login credentials.

That's it! You've finished the basic setup with the openUBMC init script. Your environment is now good to go for the next steps, like building and developing— we'll cover those in the upcoming sections.

Configuring Your GitCode Account ​

Before cloning and building the source code, configure your GitCode account for SSH access. Follow the official guide: Adding SSH Keys on GitCode.

git config --global user.name <your username>
git config --global user.email <your email>
ssh-keygen -t rsa -b 2048 -C <your email>
cat ~/.ssh/id_rsa.pub