# Shared Resources

This directory contains shared assets that can be used across multiple applications in the mj-infra-flux Kubernetes cluster.

## Directory Structure

```
/home/jim/docs/data/systems/shared-resources/
├── icons/              # General application icons (PNG, SVG, etc.)
├── icons-logos/        # Application logos and branding
│   └── home-assistant-logo/
└── README.md          # This file
```

## Usage

### For Authentik (and other apps)

Application icons and logos stored here can be mounted into Kubernetes pods using hostPath volumes.

Example usage in a Kubernetes deployment:

```yaml
volumes:
  - name: shared-icons
    hostPath:
      path: /home/jim/docs/data/systems/shared-resources/icons-logos
      type: Directory

volumeMounts:
  - name: shared-icons
    mountPath: /app/media/icons
    readOnly: true
```

### For Authentik Specifically

Authentik can use these icons for:
- Application icons in the user portal
- Provider/IdP branding
- Custom theming

To use with Authentik:
1. Mount the icons into the Authentik pod at `/media` or custom path
2. Configure application icons via the Authentik Admin UI
3. Reference the mounted path when setting application icons

### Adding New Icons

1. Place icon files in the appropriate subdirectory:
   - `icons/` - for general app icons (favicons, app icons)
   - `icons-logos/` - for larger logos and branding assets

2. Use consistent naming:
   - `app-name-icon.png` (for small icons)
   - `app-name-logo.png` (for logos)
   - `app-name-logo.svg` (for vector logos)

3. Recommended formats:
   - PNG (with transparency) for raster images
   - SVG for vector graphics (preferred for logos)
   - Sizes: 192x192, 512x512 for icons; any size for SVG

## Mount Path

NFS Mount: `/home/jim/docs/data/systems/shared-resources/`

This path is accessible from:
- The k3s cluster node (deby - 192.168.68.71)
- Local development machine (as shown above)
- Any pod with appropriate hostPath volume mounts

## Security

- Icons are read-only for most applications
- No sensitive data should be stored here
- All files are backed up as part of the NFS volume backup strategy