# waz-here/ubuntu24.04 architecture

> Architecture diagram of the GitHub repository waz-here/ubuntu24.04, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/waz-here/ubuntu24.04
- Repository: https://github.com/waz-here/ubuntu24.04

## Overview

This repository provides Ubuntu scripts and materials for workshops, including a routing lab built around a Dynamips topology, with separate Guacamole and jumphost resources. The root README documents downloading the repository and making shell scripts executable, but no source excerpts or detailed subsystem documentation were provided. Accordingly, the graph shows the documented installation entry point and the major tree-visible components without asserting runtime connections between them.

Main entry points: [`README.md`](https://github.com/waz-here/ubuntu24.04/blob/main/README.md) (Ubuntu scripts guide)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workshops["Workshop materials"]
  node_install["Ubuntu scripts guide<br/>[README.md]"]
  node_student["Student guide<br/>[README.md]"]
  node_workshops_readme["Workshop overview<br/>[README.md]"]
end

subgraph group_routing["Routing lab"]
  node_routing_readme["Routing workshop guide<br/>[README.md]"]
  node_routing_setup["Routing setup"]
  node_routing_tls["HTTPS setup"]
  node_topology["Router topology<br/>[topology.net]"]
  node_router_configs["Router configurations"]
  node_dynamips_start["Start Dynamips<br/>[start_dynamips.sh]"]
  node_lab_launch["Launch lab<br/>[launch_lab.sh]"]
  node_lab_status["Lab status<br/>[status_lab.sh]"]
  node_dynamips_stop["Stop Dynamips<br/>[stop_dynamips.sh]"]
end

subgraph group_access["Remote access"]
  node_guac_readme["Guacamole guide<br/>[README.md]"]
  node_guac_compose["Guacamole deployment example"]
  node_guac_password["Change Guacamole password"]
  node_jump_readme["Jumphost guide<br/>[README.md]"]
  node_jump_key["Add instructor SSH key"]
  node_console_menu["Router console menu"]
end

node_admin(("Workshop administrator"))

node_admin -->|"follows install guide"| node_install

click node_install "https://github.com/waz-here/ubuntu24.04/blob/main/README.md"
click node_student "https://github.com/waz-here/ubuntu24.04/blob/main/guacamole-student-guide/README.md"
click node_workshops_readme "https://github.com/waz-here/ubuntu24.04/blob/main/workshops/README.md"
click node_routing_readme "https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/README.md"
click node_routing_setup "https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/setup_routing_workshop_ubuntu24.sh"
click node_routing_tls "https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/setup_routing_workshop_ubuntu24_letsencrypt.sh"
click node_topology "https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/dynamips/topology.net"
click node_router_configs "https://github.com/waz-here/ubuntu24.04/tree/main/workshops/routing/dynamips/configs"
click node_dynamips_start "https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/dynamips/start_dynamips.sh"
click node_lab_launch "https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/dynamips/launch_lab.sh"
click node_lab_status "https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/dynamips/status_lab.sh"
click node_dynamips_stop "https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/dynamips/stop_dynamips.sh"
click node_guac_readme "https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/guacamole/README.md"
click node_guac_compose "https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/guacamole/compose.yaml.example"
click node_guac_password "https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/guacamole/change_guacamole_password.sh"
click node_jump_readme "https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/jumphost/README.md"
click node_jump_key "https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/jumphost/add_instructor_ssh_key.sh"
click node_console_menu "https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/jumphost/router-console-menu.sh"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_install,node_student,node_workshops_readme toneBlue
class node_routing_readme,node_routing_setup,node_routing_tls,node_topology,node_router_configs,node_dynamips_start,node_lab_launch,node_lab_status,node_dynamips_stop toneAmber
class node_guac_readme,node_guac_compose,node_guac_password,node_jump_readme,node_jump_key,node_console_menu toneMint
class node_admin toneIndigo
```

## Components

### Workshop materials

- [Ubuntu scripts guide](https://github.com/waz-here/ubuntu24.04/blob/main/README.md): `README.md`
- [Student guide](https://github.com/waz-here/ubuntu24.04/blob/main/guacamole-student-guide/README.md): `guacamole-student-guide/README.md`
- [Workshop overview](https://github.com/waz-here/ubuntu24.04/blob/main/workshops/README.md): `workshops/README.md`

### Routing lab

- [Routing workshop guide](https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/README.md): `workshops/routing/README.md`
- [Routing setup](https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/setup_routing_workshop_ubuntu24.sh): `workshops/routing/setup_routing_workshop_ubuntu24.sh`
- [HTTPS setup](https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/setup_routing_workshop_ubuntu24_letsencrypt.sh): `workshops/routing/setup_routing_workshop_ubuntu24_letsencrypt.sh`
- [Router topology](https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/dynamips/topology.net): `workshops/routing/dynamips/topology.net`
- [Router configurations](https://github.com/waz-here/ubuntu24.04/tree/main/workshops/routing/dynamips/configs): `workshops/routing/dynamips/configs`
- [Start Dynamips](https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/dynamips/start_dynamips.sh): `workshops/routing/dynamips/start_dynamips.sh`
- [Launch lab](https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/dynamips/launch_lab.sh): `workshops/routing/dynamips/launch_lab.sh`
- [Lab status](https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/dynamips/status_lab.sh): `workshops/routing/dynamips/status_lab.sh`
- [Stop Dynamips](https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/dynamips/stop_dynamips.sh): `workshops/routing/dynamips/stop_dynamips.sh`

### Remote access

- [Guacamole guide](https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/guacamole/README.md): `workshops/routing/guacamole/README.md`
- [Guacamole deployment example](https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/guacamole/compose.yaml.example): `workshops/routing/guacamole/compose.yaml.example`
- [Change Guacamole password](https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/guacamole/change_guacamole_password.sh): `workshops/routing/guacamole/change_guacamole_password.sh`
- [Jumphost guide](https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/jumphost/README.md): `workshops/routing/jumphost/README.md`
- [Add instructor SSH key](https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/jumphost/add_instructor_ssh_key.sh): `workshops/routing/jumphost/add_instructor_ssh_key.sh`
- [Router console menu](https://github.com/waz-here/ubuntu24.04/blob/main/workshops/routing/jumphost/router-console-menu.sh): `workshops/routing/jumphost/router-console-menu.sh`

### Other components

- **Workshop administrator**

## Connections

- Workshop administrator → Ubuntu scripts guide: follows install guide (evidence: `README.md`)
