/ghaf

TII SSRC Secure Technologies: Ghaf Framework

Primary LanguageNixApache License 2.0Apache-2.0

TII SSRC Secure Technologies: Ghaf Framework

Ghaf Logo

License: Apache-2.0 License: CC-BY-SA 4.0 Style Guide OpenSSF Scorecard OpenSSF Best Practices Contributor Covenant

This repository contains the source files (code and documentation) of Ghaf Framework — an open-source project for enhancing security through compartmentalization on edge devices.

For information on build instructions and supported hardware, see the Reference Implementations section of Ghaf documentation.

Documentation

The Ghaf Framework documentation site is located at https://tiiuae.github.io/ghaf/. It is under cooperative development.

To build Ghaf documentation, use:

nix build .#doc

See the documentation overview under README-docs.md.

Other Project Repositories

Other repositories that are a part of the Ghaf project:

Build System

Ghaf images are built and tested by our continuous integration system. For more information on a general process, see Continuous Integration and Distribution.

Targets: https://github.com/tiiuae/ghaf/blob/main/hydrajobs.nix
Hydra builders on x86 servers: https://hydra.vedenemo.dev/
Disk images successfully built with Hydra are published to https://vedenemo.dev/.
Build results: https://vedenemo.dev/files/build_reports/

Contributing

We welcome your contributions to code and documentation.

If you would like to contribute, please read CONTRIBUTING.md and consider opening a pull request. One or more maintainers will use GitHub's review feature to review your pull request.

In case of any bugs or errors in the content, feel free to create an issue. You can also create an issue from code.

Licensing

The Ghaf team uses several licenses to distribute software and documentation:

License Full Name SPDX Short Identifier Description
Apache License 2.0 Apache-2.0 Ghaf source code.
Creative Commons Attribution Share Alike 4.0 International CC-BY-SA-4.0 Ghaf documentation.

See LICENSE.Apache-2.0 and LICENSE.CC-BY-SA-4.0 for the full license text.