Files
wild-central/web
Paul Payne d796a79f79 Add Authelia as centralized authentication and OIDC provider
Authelia runs as a managed native service on Wild Central, providing
two integration patterns for network services:

- Forward-auth via HAProxy for apps without native SSO (Lua auth-request
  script intercepts requests, redirects unauthenticated users to login portal)
- OIDC provider for apps with native support (Gitea, Grafana, etc.)

Backend: new internal/authelia/ package with service manager, config
generation, file-based user management (argon2id), and OIDC client
management. API endpoints for status, config, users CRUD, and OIDC
clients CRUD.

HAProxy: config generator extended with lua-load, auth-request
directives, and Authelia backend. Auth directives scoped to session
cookie domain — only subdomains of the auth portal's parent are
eligible for forward-auth.

Frontend: Authentication page with enable/disable, user management,
OIDC client management (add/edit/delete), and protected domains
toggles. Advanced subsystem page for raw config view. Dashboard
service card and sidebar entries.
2026-07-12 11:47:37 +00:00
..

Wild Cloud Web App

The Wild Cloud Web App is a web-based interface for managing Wild Cloud instances. It allows users to view and control their Wild Cloud environments, including deploying applications, monitoring resources, and configuring settings.

Prerequisites

Before starting the web app, ensure the Wild Central API is running:

cd ../api
make dev

The API should be accessible at http://localhost:5055.

Development

Initial Setup

  1. Copy the example environment file:
cp .env.example .env
  1. Update .env if your API is running on a different host/port:
VITE_API_BASE_URL=http://localhost:5055
  1. Install dependencies:
pnpm install
  1. Start the development server:
pnpm run dev

The web app will be available at http://localhost:5173 (or the next available port).

Other Scripts

pnpm run build # Build the project
pnpm run lint # Lint the codebase
pnpm run preview # Preview the production build
pnpm run type-check # Type check the codebase
pnpm run test # Run tests
pnpm run test:ui # Run tests with UI
pnpm run test:coverage # Run tests with coverage report
pnpm run build:css # Build the CSS using Tailwind
pnpm run check # Run lint, type-check, and tests

Environment Variables

VITE_API_BASE_URL

The base URL of the Wild Central API server.

  • Default: http://localhost:5055
  • Example: http://192.168.1.100:5055
  • Usage: Set in .env file (see .env.example for template)

This variable is used by the API client to connect to the Wild Central API. If not set, it defaults to http://localhost:5055.