goodhallsolutions/tagaris repository overview

Tagaris is self-hosted IT asset management for internal IT teams, MSPs and anyone who has outgrown the spreadsheet. It runs as two containers (the app and PostgreSQL) on a small VPS or homelab box, with about 1 GB of memory.

⁠What it does

• Hardware, software licences, domains, warranties and assignments in one place, with a dated history on every asset
• Assets belong to a person, a location, both, or neither; check-out and check-in; multi-level locations (site, floor, room, rack)
• Accessories, components and consumables with low-stock alerts
• Photos and attachments (receipts, invoices, manuals) on assets
• Printable QR label sheets for assets and locations; scan a door, audit a room
• An iOS app (iPhone and iPad) for scanning labels, lookups and audits, on the App Store (Android in development)
• CSV import (including Snipe-IT and Halo presets) and full export to CSV or JSON at any time
• Built-in reports with CSV export and print, plus a custom report builder
• A daily email digest of renewals due, warranty expiries and low stock
• Serial number intelligence: Dell, Lenovo and Apple formats recognised, with links to the maker's warranty lookup
• Scheduled encrypted backups with restore, including S3-compatible offsite
• Two-factor authentication; email by SMTP, Microsoft 365 or Google Workspace
• A documented REST API (v1) with personal and organisation keys

⁠Quick start

services:
  postgres:
    image: postgres:16-alpine
    environment:
      POSTGRES_USER: tagaris
      POSTGRES_PASSWORD: change_me
      POSTGRES_DB: tagaris
    volumes:
      - pgdata:/var/lib/postgresql/data

  app:
    image: goodhallsolutions/tagaris:latest
    depends_on:
      - postgres
    environment:
      DATABASE_URL: postgresql://tagaris:change_me@postgres:5432/tagaris?schema=public
      BETTER_AUTH_SECRET: a_long_random_secret
      BETTER_AUTH_URL: http://your-host:3000
    ports:
      - "3000:3000"
    volumes:
      - photos:/app/data/photos
      - uploads:/app/uploads

volumes:
  pgdata:
  photos:
  uploads:

Open the app and the setup wizard creates your organisation and admin account. Database migrations run automatically at start. Use letters and digits only in the database password, and set BETTER_AUTH_URL to the address people actually reach the app on.

A plain docker run install (no compose) is covered in the documentation.

⁠Free and paid

The free tier is the full register for a single administrator: no asset limit, no export limit, no trial clock. A Team licence (5, 10, 25 or 50 people) adds multiple users with roles, single sign-on, an org-wide audit log, the custom report builder, scheduled reports and API access. Keys arrive by email within minutes of checkout, activate once, and are then verified offline on your own server; air-gapped installs use a licence file with no internet at all. Team is free to try for 30 days (five seats, no card): request a key with your work email on the pricing page. Multiple organisations on one install is a paid add-on. Device sync (Microsoft Intune, Jamf) and the Microsoft Entra people import are a free beta.

⁠Tags

• latest: the current release
• 2.5.0 and other version tags: pinned releases; 2 and 2.5 follow the latest patch within that line

Images are built for linux/amd64 and linux/arm64 with provenance and SBOM attestations, and scanned with Docker Scout.

⁠Links

• Website and pricing: https://tagaris.co.uk⁠
• iOS app (iPhone and iPad): https://apps.apple.com/gb/app/tagaris/id6801475105⁠
• Live demo: https://demo.tagaris.co.uk⁠ (sign in with the credentials shown on the login page)
• Documentation: https://docs.tagaris.co.uk⁠
• Contact: [email protected]⁠