diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..5100e42
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,13 @@
+UACTF 2025 remote execution challenges source code
+
+contains dockerfile and compose creating a custom image file with scaleable and scriptable level modification.
+
+In current state this creates a docker VM with a single level
+
+to do:
+ - System for adding levels
+ - new instance for each CTF team?
+ - seperate docker service for login manager
+    - players ssh into login manager which creates and redirects to their machine
+    - load balancing
+ - Full integration into CTFD api, and potential docker alignment?