Caution

This project is currently under development

Unbound Web UI

A graphical user interface for managing and monitoring Unbound

View Demo · Report Bug · Request Feature

Important

This is an unofficial project, not affiliated with the official Unbound or its maintainers.

Table of Contents

1. About The Project
2. Key Features
3. Usages
4. Development
   • Pre requisites
   • Developer Setup
5. License

About The Project

Unbound Web UI is a graphical user interface designed to manage and monitor the Unbound DNS resolver, which is widely used for caching and recursive DNS lookups. This UI provides a more accessible and user-friendly way to interact with Unbound, offering functionalities that allow users to view real-time query statistics, manage cache, and configure various settings without needing to use command-line tools.

Key Features

• Real-Time Monitoring: Displays live statistics such as query rates, cache hit ratios, and server uptime, helping users monitor the DNS resolver's performance at a glance.
• Cache Management: Allows users to inspect, flush, or selectively remove cached entries, which is particularly useful for testing DNS changes or troubleshooting.
• Configuration Management: Provides options to modify and apply Unbound configurations, such as setting up access control lists (ACLs), enabling or disabling DNSSEC, and adjusting logging preferences.
• Security and Access Control: Offers authentication mechanisms to restrict access to authorized users, ensuring that only trusted individuals can manage Unbound settings.

Usages

Automated Install

Those who want to get started quickly and conveniently may install Unbound Web UI using the following command:

curl -sSL https://raw.githubusercontent.com/tsutsu3/unbound-web-ui/refs/heads/main/scripts/install-unbound-web-ui.sh | bash

Access Web UI

• http://localhost:3000/admin/

Development

This section provides guidance for developers and contributors who want to work on the project.

Pre requisites

• Node.js

Here’s how you can update the Develop section to include the Node.js requirement:

Developer Setup

1. Clone the Repository:

   git clone https://github.com/tsutsu3/unbdound-web-ui.git

2. Navigate to the Project Directory:

   cd unbdound-web-ui

3. Install Dependencies:

   npm install

4. Run in Development Mode:

   npm run dev

   • Starts a local development server.

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)