Getting started

Genode can be approached from two different angles: as an operating-system architecture or as a practical tool kit. This chapter assists you with exploring Genode as the latter. After introducing the recommended development environment, it guides you through the steps needed to obtain the source code (Section Obtaining the source code), to use the tool chain (Section Using the build system), to test-drive system scenarios (Section A simple system scenario), and to create your first custom component from scratch (Section Hello world).

Recommended development environment

Genode is regularly used and developed on GNU/Linux. It is recommended to use the latest long-term support (LTS) version of Ubuntu. Make sure that your installation satisfies the following requirements:

For using the entire collection of ported 3rd-party software, the following packages should be installed additionally: byacc, autoconf2.64, autogen, bison, flex, g++, git, gperf, libxml2-utils, subversion, and xsltproc.

Seeking help

The best way to get assistance while exploring Genode is to consult the mailing list, which is the primary communication medium of regular users and developers alike. Please feel welcome to join in!

Mailing Lists

https://genode.org/community/mailing-lists

If you encounter a new bug, ambiguous documentation, or a missing feature, please consider opening a corresponding issue at the issue tracker:

Issue tracker

https://github.com/genodelabs/genode/issues

Content:

  1. Obtaining the source code
  2. Source-tree structure
  3. Using the build system
  4. A simple system scenario
  5. Hello world
    1. Using a custom source-code repository
    2. Source code and build description
    3. Building the component
    4. Defining a system scenario
    5. Responding to external events
  6. Next steps