[Support] Always Bring A Gift

[note that this application isn't in Community Apps yet, working on the process and needed to start a support thread]

Always Bring a Gift (ABAG) is a simple, self-hosted gift-tracking application designed to help you remember events, track people, and keep gift ideas organized across holidays, birthdays, celebrations, and family traditions.

This thread serves as the official support and discussion area for running ABAG on Unraid through Community Applications.

🎁 What Is ABAG?

If you’ve ever forgotten what you gave someone last year—or had a great idea weeks before an event and promptly forgot it—ABAG helps solve that.

The app lets you:

• Track people and their preferences

• Record gift ideas for any time of year

• Organize events and prepare ahead

• Maintain a gift history so you always know what you’ve given

• Keep everything tidy in one simple, self-hosted interface

It’s designed to be lightweight, easy to use, and easy to run on Unraid.

🚀 Features

• Clean, modern web interface

• Fast search and filtering

• Track ideas, gifts, and events

• Bulk import people from CSV or vCard files

• Add notes, links, prices, and more

• Automatic tracking of gift history

• Compatible with desktop and mobile browsers

🔑 Initial Login & First-Time Account Setup

When ABAG starts for the first time, it automatically creates your initial admin account with a random admin password.

You can find it in the container logs:

1. Go to Docker in Unraid

2. Click the icon next to the ABAG container

3. Select the Logs option in the menu

4. Look for the line showing your generated admin password

You can then log in using:

Email: [email protected]

Password: (shown in the logs)

After logging in, you can change these credentials from within the application.

🧪 Beta Status

Always Bring a Gift is currently in beta and under active development.

This means:

• Features may evolve

• UI refinements are ongoing

• Feedback is welcome and appreciated

• Breaking changes are possible prior to 1.0
  

If you encounter issues or have suggestions, please post them here or open an issue on GitHub.

🛠️ Configuration Notes

Trusted Proxies (TRUSTED_PROXIES)

If you use a reverse proxy (Traefik, Nginx Proxy Manager, SWAG, etc.), ABAG needs to know which proxies it should trust when interpreting incoming request headers (IP address, HTTPS detection, etc.).

Default behavior:

• The Docker image ships with TRUSTED_PROXIES="*" to simplify local and homelab deployments.

• This means all proxies are trusted unless you override the value.

If you expose ABAG publicly (not generally recommended):

You should explicitly set one of the following:

• Empty string ("") — trust no proxies

• Comma-separated list — trust only specific proxies

Amazon Product Images (OPENWEB_NINJA_KEY)

ABAG will always attempt to retrieve a product image from any URL you enter when adding a gift idea.

For most retailers this works automatically — but Amazon actively blocks direct image scraping, and their official Product Advertising API is not practical for most self-hosted users.

To help with this, ABAG includes optional integration with OpenWeb Ninja, a lightweight Amazon metadata API. It supports a free tier (100 requests/month), which is more than enough for typical use.

To enable Amazon image fetching, set:

If the key is not set, ABAG will still work normally — Amazon images will simply not be retrievable, while all other retailer URLs continue to function as usual.

Single Sign-On via Authentik

ABAG supports logging in through Authentik for users who prefer centralized authentication or SSO across their self-hosted services.

Instead of duplicating setup steps here, please refer to the official guide in the project repository:

👉 Authentik Setup Guide: https://github.com/Indemnity83/always-bring-a-gift/blob/main/AUTHENTIK_SETUP.md

This document walks you through:

• Creating the correct OAuth2 provider

• Registering an ABAG application in Authentik

• Configuring redirect URLs

• Setting the required environment variables in Unraid

Once those variables are set, ABAG automatically enables Authentik login.

💬 Support & Feedback

• GitHub Issues: https://github.com/Indemnity83/always-bring-a-gift/issues

• Project Repository: https://github.com/Indemnity83/always-bring-a-gift

• README / Documentation: https://github.com/Indemnity83/always-bring-a-gift/blob/main/README.md

Feel free to post below if you need help, have a feature request, or spot a bug.

🙌 Thank You

Thanks for trying Always Bring a Gift on Unraid!

Your feedback directly helps shape the app toward a polished 1.0 release.