Moduletrace/wireguard-ui
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
tben
2026-09-20 18:38:34 +01:00
parent acbde93494
commit bd1aa199d3
2 changed files with 34 additions and 39 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+8 -12
View File
@@ -9,14 +9,14 @@ An admin dashboard for Wireguard — manage hosts, clients, tunnels, and IP rule
- **Client Rules** — Define IP table rules per client (rule type, destination, ports, protocol)
- **Media Management** — Upload and manage media assets (images, documents, etc.) with tagging, thumbnails, and RAG ingestion
- **User Management** — Multi-user support with role-based access (user types)
- **Persistent Storage** — MariaDB-backed database with automatic schema generation
- **Persistent Storage** — SQLite database with automatic schema generation
- **WebSocket Support** — Real-time updates via WebSocket connections
- **Responsive UI** — Tailwind CSS v4 with twui design system components
## Prerequisites
- **Bun** 1.3.1 or later ([install](https://bun.sh/install))
- **MariaDB** (or compatible SQL database)
- **SQLite** (via `@moduletrace/bun-sqlite`)
- **git**
- **Linux** (Debian, Ubuntu, Fedora, Arch, Alpine, or similar)
- Root access (for installation script and system service setup)
@@ -84,7 +84,7 @@ The dev server runs on port **10752** by default.
The `.env` file (gitignored) controls runtime behavior. It is auto-generated during installation if missing:
| Variable | Description | Default |
| ------------------- | ------------------------------------ | -------------------- |
| ----------------- | ---------------------------------------- | -------------------- |
| `NODE_ENV` | Environment (`development`/`production`) | `production` |
| `ENCRYPTION_KEY` | Encryption key for sensitive data | Auto-generated |
| `ENCRYPTION_SALT` | Encryption salt for sensitive data | Auto-generated |
@@ -117,15 +117,11 @@ export const SiteData = {
## Available Scripts
| Command | Description |
| ------------------- | ------------------------------------------------ |
| ------------------- | ----------------------------------------- |
| `bun run dev` | Start development server (requires root) |
| `bun run start` | Start production server |
| `bun run build` | Build with bunext |
| `bun run db:schema` | Generate/update database schema and types |
| `bun run db:admin` | Open database admin interface |
| `bun run deploy:prod` | Deploy to production server |
| `bunx tsc --noEmit` | Type-check only (no emit) |
| `bun test <file>` | Run individual test files |
## Project Structure
@@ -176,11 +172,11 @@ wireguard-ui/
The database consists of the following tables:
| Table | Description |
| ---------------- | ---------------------------------------------- |
| ----------------- | ----------------------------------------------- |
| `users` | User accounts (name, email, username, password) |
| `user_types` | User type assignments per user |
| `media` | Media assets (images, documents, etc.) |
| `media_paradigms`| Media paradigm classifications per media item |
| `media_paradigms` | Media paradigm classifications per media item |
| `clients` | WireGuard clients per host |
| `hosts` | WireGuard host configurations |
| `client_rules` | IP table rules for each client |
@@ -209,7 +205,7 @@ This will:
### Docker Production
The Docker image (`Dockerfile`) is based on `oven/bun:1.3.1-debian` with MariaDB client tools installed:
The Docker image (`Dockerfile`) is based on `oven/bun:1.3.1-debian`:
```bash
docker build -t bunext-mariadb .
@@ -225,7 +221,7 @@ The server runs on the port defined in `SiteData.ServerPort` (default: **10752**
## Admin Route Hierarchy
| Route Pattern | Access | Features |
| ------------------- | ----------------------------- | ------------------------------------------- |
| ------------------- | ------------------------------- | ------------------------------------------------------------------------------------ |
| `/admin/*` | Residents | Access booking, payments, chat, dependants, notifications, events, settings, support |
| `/admin/admin/*` | Admin / ExCo | User management, payment schemes, documents, chat group management |
| `/admin/security/*` | Security / ExCo / Manager / ACo | Gate control, guest access monitoring, dependant verification |
package.json
-1
View File
@@ -8,7 +8,6 @@
"build": "bunx bunext build",
"db:schema": "bunx bun-sqlite schema -t",
"db:admin": "bunx bun-sqlite admin",
"deploy:prod": "./deploy/deploy-prod.sh",
"start": "NODE_ENV=production bun src/server.ts"
},
"devDependencies": {