Add README.md with project overview, features, requirements, and installation instructions
This commit is contained in:
30
README.md
Normal file
30
README.md
Normal 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
|
||||
```
|
||||
Reference in New Issue
Block a user