Skip to content
@range42

Range#42

README.md

Welcome to range42

range42 is a modular cyber range platform based on Proxmox + Ansible for deploying reproducible offensive, defensive and hybrid training environments. One operator workstation can manage multiple Proxmox infrastructures each running multiple lab scenarios. Everything is infrastructure-as-code.

Get started

If you want to... Read
Deploy your first scenario (full hands-on walkthrough, every wizard step explained) GETTING_STARTED.md
Operate your lab daily (range42-context: switch contexts, deploy/undeploy, SSH into VMs, view credentials) GETTING_STARTED.md - Using range42-context
Get the project context (mission, roadmap, host groups, stack) range42/README.md
Understand the vocabulary (codename, scenario, workspace, vault...) GLOSSARY.md
Try a documented network lab (2 subnets, 4 VMs, network diagram) blank_scenario_2_subnets

What's in this org

Repo Purpose
range42 Main repository including an installation wizard, Start here.
range42-playbooks Lab scenarios - demo_lab (full SIEM + CTF), blank_scenario_2/4/6_subnets (network labs).
range42-catalog Reusable Ansible roles (firewalls, packages, dotfiles, wazuh, etc.) used by scenarios.
range42-ansible_roles-proxmox_controller Wraps the Proxmox API - create/clone/delete VMs, templates, networks.
range42-ansible_roles-debug-devkit Helper scripts for snapshots, reverts, debugging individual VMs.
range42-backend-api Backend API for deployer-ui (work in progress).
range42-deployer-ui Frontend UI for deployer-ui (work in progress).

Contributing

This is a collaborative initiative for applied security training and community capability building.

Want a specific product, CVE or misconfiguration added? Open an issue on the range42-catalog repo - we centralise catalog requests there.

Found a bug or have a feature request for range42 itself? Open an issue on the range42 repo (anything not related to the catalog goes here).

We will prioritise as fast as we can.

Community health files: .github/community

Authors and contributors

Name Company / Affiliation Website
Benjamin Collas DIGISQUAD DIGISQUAD
Philippe Parage NC3 NC3

Popular repositories Loading

  1. range42-ansible_roles-proxmox_controller range42-ansible_roles-proxmox_controller Public

    RANGE42 - Ansible role for proxmox API automation with JSON output

    5

  2. range42 range42 Public

    RANGE42 – Main repository and entry point for setup and deployment on your Proxmox nodes

    Python 5 1

  3. range42-catalog range42-catalog Public

    RANGE42 - A collection of ansible roles and Docker/Compose files forming deployable bundles for the deployer backend API.

    Jinja 3

  4. range42-deployer-ui range42-deployer-ui Public

    RANGE42 - Frontend interface to design and configure infrastructure schemas for automated deployment.

    Vue 3

  5. gh-repo-organizer gh-repo-organizer Public

    Scripts to check, clone and organize the repositories.

    Shell 2

  6. range42-presentation range42-presentation Public

    Main repo for any presentations related to range#42

    TeX 2

Repositories

Showing 10 of 11 repositories
  • range42 Public

    RANGE42 – Main repository and entry point for setup and deployment on your Proxmox nodes

    range42/range42’s past year of commit activity
    Python 5 AGPL-3.0 1 17 1 Updated Apr 13, 2026
  • .github Public

    This public repository contains the default community health files for the range42 organization. GitHub will automatically use these files in any public repo under range42 that does not provide its own version.

    range42/.github’s past year of commit activity
    1 GPL-3.0 0 0 0 Updated Apr 13, 2026
  • range42-playbooks Public

    RANGE42 - Infrastructures deployer playbooks for bundles and scenarios

    range42/range42-playbooks’s past year of commit activity
    Shell 1 GPL-3.0 0 10 0 Updated Apr 10, 2026
  • range42-ansible_roles-proxmox_controller Public

    RANGE42 - Ansible role for proxmox API automation with JSON output

    range42/range42-ansible_roles-proxmox_controller’s past year of commit activity
    5 GPL-3.0 0 9 0 Updated Apr 10, 2026
  • range42-catalog Public

    RANGE42 - A collection of ansible roles and Docker/Compose files forming deployable bundles for the deployer backend API.

    range42/range42-catalog’s past year of commit activity
    Jinja 3 GPL-3.0 0 94 0 Updated Apr 8, 2026
  • range42-ansible_roles-debug-devkit Public

    RANGE42 - devkit - Helper scripts to inject and execute playbooks on the fly for development and debugging

    range42/range42-ansible_roles-debug-devkit’s past year of commit activity
    Shell 1 GPL-3.0 0 1 0 Updated Apr 3, 2026
  • range42-backend-api Public

    RANGE42 - Backend API orchestrator running Ansible catalog playbooks on requests from the front-end deployer UI.

    range42/range42-backend-api’s past year of commit activity
    Python 1 GPL-3.0 0 21 0 Updated Apr 3, 2026
  • range42-deployer-ui Public

    RANGE42 - Frontend interface to design and configure infrastructure schemas for automated deployment.

    range42/range42-deployer-ui’s past year of commit activity
    Vue 3 GPL-3.0 0 27 0 Updated Apr 3, 2026
  • range42-api-definitions Public

    RANGE42 - Swagger spec repository providing the backend API definition in JSON

    range42/range42-api-definitions’s past year of commit activity
    0 0 0 0 Updated Apr 3, 2026
  • gh-repo-organizer Public

    Scripts to check, clone and organize the repositories.

    range42/gh-repo-organizer’s past year of commit activity
    Shell 2 GPL-3.0 0 2 0 Updated Apr 3, 2026
View all repositories

Top languages

Loading…

Most used topics

Loading…