KingdomMangementPortal

Membership management system for SCA Kingdoms.

Please review the wiki for solution details https://github.com/Ansteorra/KMP/wiki

🚀 Deploy KMP

One-Line Install

macOS/Linux:

curl -fsSL https://raw.githubusercontent.com/jhandel/KMP/main/installer/scripts/install.sh | bash && kmp install

Windows (PowerShell):

irm https://raw.githubusercontent.com/jhandel/KMP/main/installer/scripts/install.ps1 | iex; kmp install

Supported Platforms

Docker · Fly.io · Railway · Azure · AWS · Any VPS

📖 Full Deployment Guide

Dev users all have the password "TestPassword"

Dev Users :

• admin@amp.ansteorra.org - System super user
• agatha@ampdemo.com - Local MoAS
• bryce@ampdemo.com - Local Seneschal
• caroline@ampdemo.com - Regional Seneschal
• devon@ampdemo.com - Regional Armored
• eirik@ampdemo.com - Kingdom Seneschal
• garun@ampdemo.com - Kingdom Rapier
• haylee@ampdemo.com - Kingdom MoAS
• iris@ampdemo.com - Basic User
• jael@ampdemo.com - Pricipality Coronet
• kal@ampdemo.com - Local Landed Nobility with a Canton
• forest@ampdemo.com - Crown
• leonard@ampdemo.com - Local Landed Nobility with Stronghold
• mel@ampdemo.com - Local Exchequer and Kingdom Social Media

Utility Scripts

fix_permissions.sh

Fixes file permissions for Apache web server access. Run this if you encounter permission errors with logs, tmp, or images directories:

./fix_permissions.sh

reset_dev_database.sh

Resets the development database to a clean state with seed data:

./reset_dev_database.sh

load_test.sh

Runs performance sizing benchmarks (route latency, concurrency, and DB query profile) against the application:

./load_test.sh

Optional environment overrides:

KMP_BASE_URL=http://127.0.0.1:8080 \
KMP_LOGIN_EMAIL=admin@amp.ansteorra.org \
KMP_LOGIN_PASSWORD=TestPassword \
KMP_CONCURRENCY_LEVELS=1,5,10,20 \
KMP_CPU_TARGET_UTIL_PCT=70 \
KMP_MEMORY_TARGET_UTIL_PCT=80 \
./load_test.sh

security-checker.sh

Runs security checks on the application:

./security-checker.sh

create_erd.sh

Generates Entity Relationship Diagrams for the database schema:

./create_erd.sh

make_amp_seed_db.sh

Creates a seed database for the application:

./make_amp_seed_db.sh

merge_from_upstream.sh

Merges changes from the upstream repository:

./merge_from_upstream.sh