Skip to content

DocKernBuilder provides an easy-to-use Docker environment for building old Linux kernels required for IOT security research. The setup uses Docker Compose to ensure that all necessary dependencies and configurations are managed within a container.

License

Notifications You must be signed in to change notification settings

R3dHash/DocKernBuilder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DocKernBuilder

DocKernBuilder provides an easy-to-use Docker environment for building old Linux kernels required for IOT security research. The setup uses Docker Compose to ensure that all necessary dependencies and configurations are managed within a container.

Table of Contents

Introduction

This repository contains a Docker setup for compiling the Linux kernel for MIPS architecture. The Docker environment simplifies the build process by providing all required dependencies, including the GCC cross-toolchain, within an isolated container.

Prerequisites

Before using this project, make sure you have the following installed:

Setup

  1. Clone this repository to your local machine:

    git clone https://github.com/R3dHash/DocKernBuilder.git
    cd DocKernBuilder
  2. Ensure that the docker-compose.yml and Dockerfile are in the same directory.

  3. The shared directory ./shared will be used to store kernel sources, logs, and compiled kernel binaries.

Build Instructions

  1. Start the container with Docker Compose:

    docker-compose up --build
  2. Once the container is running, it will automatically begin the process of downloading, extracting, and compiling the Linux kernel for MIPS.

  3. The kernel image (vmlinux) and a stripped version (vmlinux-stripped) will be available in the ./shared directory on your host machine after the build completes.

Logging and Output

The logs of the kernel build are saved inside the container and can be accessed using the following commands:

docker logs kernel_builder

Additionally, logs are saved in /shared/build.log.

Screenshots

Include screenshots of the following steps:

  1. DocKernBuilder tree project

    Docker Compose Running

  2. Docker Compose running the build

    Docker Compose Running

  3. Kernel Compilation Log

    Kernel Compilation Log

  4. Compiled Kernel Output

    Compiled Kernel Output

Troubleshooting

Common Issues

  • Out of memory errors: If your system runs out of memory during the build process, consider limiting the number of jobs (-j flag) in the Dockerfile.
  • Slow build times: You can improve build times by allocating more resources to Docker (CPU and memory).

For more troubleshooting help, please consult the Docker documentation or raise an issue in this repository.

About

DocKernBuilder provides an easy-to-use Docker environment for building old Linux kernels required for IOT security research. The setup uses Docker Compose to ensure that all necessary dependencies and configurations are managed within a container.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published