https://github.com/genuinetools/contained.af

A stupid game for learning about containers, capabilities, and syscalls.
https://github.com/genuinetools/contained.af

apparmor containers docker game linux opencontainers seccomp security syscalls

Last synced: about 2 months ago
JSON representation

A stupid game for learning about containers, capabilities, and syscalls.

• Host: GitHub
• URL: https://github.com/genuinetools/contained.af
• Owner: genuinetools
• License: mit
• Created: 2016-05-23T00:45:06.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2023-05-11T20:38:28.000Z (about 2 years ago)
• Last Synced: 2025-04-12T16:50:31.114Z (3 months ago)
• Topics: apparmor, containers, docker, game, linux, opencontainers, seccomp, security, syscalls
• Language: JavaScript
• Homepage: https://contained.af
• Size: 17.5 MB
• Stars: 898
• Watchers: 29
• Forks: 60
• Open Issues: 14
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• Awesome-CloudSec-Labs - Contained.af - hosted Challenge| [Jessie Frazelle](https://twitter.com/jessfraz) | A container escape challenge, break out of it and email the author| (Sorted by Technology and Category)

README

        
# contained.af

[![make-all](https://github.com/genuinetools/contained.af/workflows/make%20all/badge.svg)](https://github.com/genuinetools/contained.af/actions?query=workflow%3A%22make+all%22)

[![make-image](https://github.com/genuinetools/contained.af/workflows/make%20image/badge.svg)](https://github.com/genuinetools/contained.af/actions?query=workflow%3A%22make+image%22)

[![GoDoc](https://img.shields.io/badge/godoc-reference-5272B4.svg?style=for-the-badge)](https://godoc.org/github.com/genuinetools/contained.af)

[![Github All Releases](https://img.shields.io/github/downloads/genuinetools/contained.af/total.svg?style=for-the-badge)](https://github.com/genuinetools/contained.af/releases)

A game for learning about containers, capabilities, and syscalls.

To add a question edit this file: [frontend/js/questions.js](frontend/js/questions.js).

**Table of Contents**

- [Run contained.af locally](#run-containedaf-locally)

## Run contained.af locally

Contained is made of a few components:

  * A static HTML and JavaScript frontend in `frontend/`

  * A Go web server in the project root

  * An isolated Docker installation, running inside a Docker container

    ("Docker-in-Docker").

Prepare the static frontend assets with:

```

make dev

```

Start an isolated Docker instance in the background with:

```

make dind

```

Build and run the server with:

```

make run

```

After a few moments, contained will be available at http://localhost:10000/.