Add README.md with project overview, features, requirements, and installation instructions

This commit is contained in:
2025-12-28 13:03:22 +01:00
parent fa95fd0279
commit 62586de020

30
README.md Normal file
View File

@@ -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
```