Skip to content

rugo/berlyne

Repository files navigation

Berlyne

Berlyne is a trainings platform for applied IT security.

The basic workflow is this:

  • Create a course, activate scoreboard and write ups if wanted
  • Assign software problems - in the form of CTF tasks - to the course
  • Berlyne starts the required problems in virtual machines
  • The problems description in the course gets updated with correct IP, ports and downloads
  • Participants join the course and solve the problems
  • Teacher accesses the course write ups

All that is done via a Web UI.

The platform is ready to be worked with, but is also still under heavy construction.

Live Demo

Check out the live demo here!

Just register an account and join the course Example.

The given email adress is not used in any way except for the "Lost Password" function.

Requirements

The current Version 0.1 is tested with Python 3.4 and Django 1.10 on Debian but should also work with higher Python versions and other Unix derivates.

Installing

On how to install Berlyne, please consult the wiki page Installing Berlyne

Problems

Tasks in Berlyne are called problems, for pun reasons.

It is very easy to create your own problems, see the wiki for details.

Also have a look at the example problems:

Finding Problems

Tasks can be shared via repository/download/usb stick/whatever, since they only consist of three files.

Tasks shared by membes of the community are listed in the Problems Wiki Page.

On how to install them, please consult the wiki.

Virtual Machines

Berlyne automatically creates and starts VMs in the background and maps required ports to the host system.

Supported providers for launching those VMs are:

  • Docker for developement, see wiki
  • VirtualBox
  • DigitalOcean, which is a cloud provider (API-Key needed)

Contributing

Pull-Requests are very welcome.

If you want to share a task, please make sure to add the url to our Berlyne Problems Blockhain or just write an issue and I'll add it!

Contact

You can directly contact me @ berlyne[at]ht11[dot]org