ElyAccess

Open-source access control gateway by Elysium Arc. Manages Hikvision terminals, captures clock events via webhooks, and forwards them to your integrations in real-time.

Quick Start

# Clone & install
git clone https://github.com/Elysium-Arc/elyaccess.git
cd elyaccess
pnpm install

# Configure
cp .env.example .env
# Edit .env with your settings

# Setup database
npx prisma migrate deploy

# Run
pnpm dev

Environment Variables

Copy .env.example to .env and configure:

Variable	Required	Description
DATABASE_URL	✅	MySQL connection string
SESSION_SECRET	✅	Secret for session encryption
NODE_ENV		development or production
PORT		Server port (default: 3001)
SERVER_IP		Server IP address
SSL		Enable HTTPS (true/false)

Default Login

• Username: admin
• Password: admin

Change password on first login.

Commands

pnpm dev      # Development server with hot reload
pnpm build    # Production build
pnpm start    # Start production server
pnpm test     # Run tests
pnpm repl     # Interactive database REPL

REPL Console

Access the interactive database console:

pnpm repl

Available commands:

• await getDevices() - List all devices
• await getEvents() - List events
• await showTableStats() - Database statistics
• await resetAdminPassword() - Reset admin password
• prisma - Direct Prisma client access

Docker

docker-compose up -d

Tech Stack

• Node.js + TypeScript + Express
• Prisma + MySQL
• HTMX + Tailwind CSS
• EJS templates

License

MIT © Elysium Arc