https://github.com/ludiazv/composeos

A container only linux for SBCs
https://github.com/ludiazv/composeos

Last synced: 9 days ago
JSON representation

A container only linux for SBCs

• Host: GitHub
• URL: https://github.com/ludiazv/composeos
• Owner: ludiazv
• Created: 2023-07-11T08:16:45.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2023-10-09T12:37:29.000Z (about 1 year ago)
• Last Synced: 2023-10-09T13:39:09.210Z (about 1 year ago)
• Language: Shell
• Size: 58.6 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

        
# ComposeOs - A container only linux for SBCs

**ComposeOs** is a small image for ARM SBCs that intended to run containers in single boards computers (like raspberry Pi). **composeOs** is minimal and features simple configuration in a **yaml** format to 

**WARNING: composeOs is alpha version and some features are not fully tested. Please consider if you want to use in production**

## Documentation

Please check (the doc)[docs/composeos.md].

## Boards

Currently only this boards are built:

- Raspberry Pi 4

- Raspberry Pi 3

- Orange Pi Zero 2

- Banana PI M2 Zero

Only 64bit images are provided for 64bit capable SoCs.

## Contribute

At this phase of development the most appreciable contribution are:

- Testing the software and report the issues in the issues page.

- Improve the documentation.

- Provide examples of composeos.yml and software stacks.

- Contribute with additional stack templates.

- Add and test other boards.

If you want to contribute to the code base please note the following comments:

- composeOs is based on yocto/oe, you need to be familiar with yocto concepts to understand the structure of the project.

- All custom code is implemented in POSIX shell. No bashims are allowed, bash is not even installed.

- Most linux core utils are provided by Busybox that does not provide full funtionality.

- The init system is openRC.

- The _composeos.py_ in the root folder is a custom bulider using containers and is not part of the software deployed in the SBC.

- The container engine is podman and the composer is podman-compose.

- libc is musl to reduce system footprint.

## TODO

- Implement populate for tarballs.

- Include additonal images: RPI ZERO W ,  RPI ZERO 2, Orange PI 3 LTS , Orange PI Zero 3.

- Rockchip family integration.