This repository provides a template for creating task definitions for Hack4Krak events. It is parsed directly by our website to display detailed information about specific Capture the Flag (CTF) challenges.
The repository includes basic tools for verifying, parsing, and task creation.
Important
Workflows by default don't run on pull request from forks on private repositories. To enable them edit your organization settings. Refer to GitHub documentation for more information.
For more information check out our documentation!
Required only for running Hack4Krak Toolbox
uv syncuv run pre-commit installuv run toolbox - tasks/ - configuration for all tasks
- config/ - configuration for the specific CTF event
- toolbox/ - our custom CLI for working with this repository
- docs/ - documentation
The repository includes a comprehensive testing infrastructure for both CI and deployment tests.
See docs/TESTING.md for writing and running tasks tests.
Service deployment is handled through Docker Swarm.
See docs/DEPLOYMENT.md for target configuration, Traefik labels, and toolbox commands.
