Asset Tracker

Open-source IT asset management for teams of any size.

Track hardware, software licences, consumables, and accessories — with role-based access, audit logging, SSO, and integrations built in.

Features · Quick Start · Deployment · Configuration · Contributing

---

Features

Asset Management Full lifecycle tracking (procure, deploy, maintain, retire) Check-out / check-in with audit trail Reservations and approval workflows File attachments with image gallery and thumbnails QR code generation, printing, and scanning Custom fields per asset category Depreciation tracking and warranty alerts	Users & Access Control 35 granular RBAC permissions Multi-tenancy with organization and department scoping Microsoft Entra ID (Azure AD) SSO LDAP / Active Directory authentication SAML SSO support MFA / 2FA with TOTP and backup codes Per-user preferences (date, number, currency formats)
Inventory Licences — seat assignment and compliance monitoring Accessories — check-out tracking with quantity management Consumables — stock levels with reorder alerts Components — categorized tracking and assignment	Ticketing & Workflows Built-in ticket system with Kanban board Automated workflow engine (conditions + 5 action types) Maintenance scheduling and reminders Request and approval flows
Integrations Slack & Microsoft Teams notifications Webhooks — HMAC-signed with retry and delivery logs Freshdesk ticket sync Stripe billing (SaaS mode) Email — Brevo, SendGrid, Mailgun, Postmark, SES	Security & Compliance AES-256-GCM encryption at rest Audit logging with full entity diffs GDPR data retention enforcement (automated cron) Rate limiting and account lockout Concurrent session management CSP, HSTS, and security headers
Dashboard & Reporting Drag-and-drop customizable widgets Charts: lifecycle, cost, location, maintenance, depreciation CSV and PDF export Typeahead search with filterable URLs	Mobile & PWA Progressive Web App with install prompt Mobile-optimized navigation and tables QR scanning for asset lookup

---

Tech Stack

Layer	Technology
Framework	Next.js 16 (App Router, Turbopack)
Language	TypeScript 5.9
Database	PostgreSQL + Prisma 7 (42 models)
Auth	BetterAuth — sessions, SSO, MFA
UI	Tailwind CSS 4 + shadcn/ui
Validation	Zod
Charts	Recharts
Monitoring	Sentry / Glitchtip
Testing	Vitest + Playwright

---

Quick Start

Prerequisites

• Node.js 18+ or Bun
• PostgreSQL database

1. Clone and install

git clone https://github.com/luca-fitseveneleven/assetTracker.git
cd assetTracker
bun install

2. Configure environment

cp .env.example .env

Set at minimum:

DATABASE_URL=postgresql://user:password@localhost:5432/assettracker
BETTER_AUTH_URL=http://localhost:3000
BETTER_AUTH_SECRET=          # generate with: openssl rand -base64 32
ENCRYPTION_KEY=              # generate with: openssl rand -hex 32

3. Set up the database

npx prisma migrate deploy
npx prisma generate

4. Create an admin user

bun run create-admin

5. Start the server

bun dev

Open http://localhost:3000 and sign in.

---

Deployment

Docker

docker build -t asset-tracker .
docker run -p 3000:3000 --env-file .env asset-tracker

Docker Compose

services:
  app:
    build: .
    ports:
      - "3000:3000"
    env_file: .env
    depends_on:
      - db
  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: assettracker
      POSTGRES_USER: assettracker
      POSTGRES_PASSWORD: changeme
    volumes:
      - pgdata:/var/lib/postgresql/data

volumes:
  pgdata:

Vercel

Set the environment variables in the Vercel dashboard and connect your PostgreSQL database.

Any Node.js Host

bun run build
bun start

---

Configuration

All configuration is via environment variables. Copy .env.example for the full reference.

Category	Key Variables	Required
Database	DATABASE_URL	Yes
Auth	BETTER_AUTH_URL, BETTER_AUTH_SECRET	Yes
Encryption	ENCRYPTION_KEY	Recommended
Microsoft SSO	MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID	No
Email	EMAIL_PROVIDER, provider API keys	No
Storage	STORAGE_PROVIDER (local, s3, azure)	No
Integrations	Slack/Teams webhooks, Freshdesk API key	No
Billing	STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET	No
Redis	UPSTASH_REDIS_REST_URL, UPSTASH_REDIS_REST_TOKEN	No
CAPTCHA	TURNSTILE_SECRET_KEY, NEXT_PUBLIC_TURNSTILE_SITE_KEY	No
Self-hosted	SELF_HOSTED=true — disables landing page, pricing, registration	No

---

Scripts

Command	Description
bun dev	Start dev server (Turbopack)
bun run build	Production build
bun start	Start production server
bun run lint	ESLint
bun run format	Prettier
bun run test	Unit tests (Vitest)
bun run test:e2e	E2E tests (Playwright)
bun run db:seed	Seed database
bun run create-admin	Create admin user

---

Project Structure

src/
├── app/                    # Next.js App Router — pages & API routes
│   ├── api/                # 100+ REST API endpoints
│   ├── assets/             # Asset management pages
│   ├── dashboard/          # Customizable widget dashboard
│   ├── admin/              # Admin settings & configuration
│   └── ...                 # Licences, accessories, consumables, etc.
├── components/             # Shared UI components (shadcn/ui)
├── hooks/                  # Custom React hooks
├── lib/                    # Core utilities
│   ├── integrations/       # Slack / Teams notification module
│   ├── storage/            # Pluggable file storage (local, S3, Azure)
│   ├── rbac.ts             # Permission system (35 permissions)
│   ├── workflow-engine.ts  # Automated workflow execution
│   └── ...                 # Auth, validation, encryption, webhooks
└── ui/                     # Page-specific UI components
prisma/
└── schema.prisma           # Data model (42 models)

---

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/my-feature)
3. Run linting and tests (bun run lint && bun run test)
4. Commit with a conventional commit message
5. Open a Pull Request

This project uses Husky pre-commit hooks with Prettier and ESLint.

---

License

MIT License — see LICENSE for details.

Copyright (c) 2026 Luca Gerlich