diff --git a/README.md b/README.md
new file mode 100644
index 0000000..44850dc
--- /dev/null
+++ b/README.md
@@ -0,0 +1,30 @@
+# Omada Custom Dynamic DNS for Mail-In-A-Box
+
+The repository contains a Flask-based API proxy that allows Omada controller to update DNS records in a Mail-In-A-Box (MIAB) server. The Omada SDN software does not natively support MIAB as a Dynamic DNS provider, so this proxy bridges that gap.
+
+## Features
+
+- Provides endpoints for listing, setting, and deleting DNS records.
+- Relays authentication credentials from Omada supplied username and password to MIAB.
+
+## Requirements
+
+- Python 3.x
+- Flask
+- Flask-HTTPAuth
+- Requests
+- Base64
+
+## Installation
+
+On an Ubuntu/Debian system, you can install the required packages using apt:
+
+```bash
+sudo apt install -y python3 python3-dotenv python3-flask python3-flask-httpauth python3-requests
+```
+
+Copy the `app.py` file to your desired location, and run it using Python:
+
+```bash
+flask run app.py
+```