# Deploy Shelf with Easypanel

URL: /templates/shelf

Shelf.nu is an open-source asset management platform designed to help organizations track and manage their physical assets efficiently. It provides features for asset tracking, inventory management, check-in/check-out functionality, and reporting. The platform includes location tracking with maps, user management, and email notifications for asset-related activities.

## Installation notes

Shelf.nu requires a Supabase project for file storage and authentication. Before deploying, create a free project at supabase.com, then copy your Project URL, anon public key, and service role key from Project Settings > API. The app will refuse to start if any of the three Supabase fields are left blank.

## Benefits

### Asset Management

Comprehensive asset tracking and management system with check-in/check-out functionality.

### Location Tracking

Built-in mapping and location tracking features for physical asset management.

### User Management

Multi-user support with role-based access control and team collaboration features.

### Email Notifications

Automated email notifications for asset activities and important updates.

## Features

### Asset Tracking

Track physical assets with detailed information, photos, and status updates.

### Check-in/Check-out

Manage asset assignments and returns with automated tracking and notifications.

### Reporting

Generate reports on asset utilization, location history, and inventory status.

### Integration Ready

Built-in Supabase integration for authentication and additional cloud services.

## Configuration

- `appServiceName` (App Service Name, required): shelf

- `appServiceImage` (App Service Image, required): ghcr.io/shelf-nu/shelf.nu:1.20.2 — Shelf.nu Docker image

- `supabaseAnonPublic` (Supabase Anonymous Public Key, required): Set during installation — Supabase anonymous public key for authentication

- `supabaseServiceRole` (Supabase Service Role Key, required): Set during installation — Supabase service role key for server-side operations

- `supabaseUrl` (Supabase URL, required): Set during installation — Your Supabase instance URL (e.g., https://yourproject.supabase.co)

- `maptilerToken` (MapTiler Token): Set during installation — MapTiler API token for location mapping features

- `smtpHost` (SMTP Host): Set during installation — SMTP server hostname for email notifications

- `smtpUser` (SMTP Username): Set during installation — SMTP username for email authentication

- `smtpFrom` (SMTP From Address): Set during installation — Email address to use as sender (e.g., "Support" <support@yourdomain.com>)

- `smtpPassword` (SMTP Password): Set during installation — SMTP password for email authentication

## Services

- shelf: app (ghcr.io/shelf-nu/shelf.nu:1.20.2)

- shelf-db: postgres

## Resources

- [Documentation](https://docs.shelf.nu/)

- [GitHub](https://github.com/shelf-nu/shelf.nu)

- [Website](https://www.shelf.nu)

- [Template source](https://github.com/easypanel-io/templates/tree/main/templates/shelf)