Subpath reverse proxy ENV support for v8+

[vipergts450]

Hello again,

Since huntarr has migrated to a database for settings with version 8, there does not seem to be a way to set a subpath in advance of going through the setup without one.

I would recommend implementing a BASE_URL environment variable similar to TZ, etc. and having it imported form the ENV, if specified in the docker command or compose file

@scr4tchy would you have time to check the below suggested implementation?

In settings_manager.py I imagine the function would look something like:

def initialize_baseurl_from_env():
    """Initialize base_url setting from BASE_URL environment variable if not already set."""
    try:
        # Get the BASE_URL environment variable
        baseurl_env = os.environ.get('BASE_URL')
        if not baseurl_env:
            settings_logger.info("No BASE_URL environment variable found, using default (no subpath) ")
            return

        # Load current general settings
        general_settings = load_settings("general")
        current_baseurl = general_settings.get("base_url")
        
        # If base_url is not set in settings, initialize it from BASE_URL environment variable
        if not current_baseurl or current_baseurl == "":
            settings_logger.info(f"Initializing base_url from BASE_URL environment variable: {baseurl_env}")
           
            # Update the settings with the base_url
            general_settings["base_url"] = baseurl_env
            save_settings("general", general_settings)
            
    except Exception as e:
        settings_logger.error(f"Error initializing base_url from environment: {e}")

The user would then be expected to restart the container for it to take effect, but since this is happening at initialization, maybe it would not be necessary?

[Admin9705]

@vipergts450 i'll see what i can do inbetween, but do not have that setup, so will run abit blind.

[Admin9705]

@vipergts450 can you try 8.0.8+ - I put some auto-detection and to have it auto-store on setup.

[vipergts450]

It does not redirect to /setup properly. The app redirects https://domain/base_url to https://domain/setup instead of https://domain/base_url/setup

[vipergts450]

the log shows that it is indeed receiving the request and attempting to redirect, so maybe the /setup route is missing the detection?

huntarr-1  | 2025-06-18 07:42:23 America/New_York - huntarr - DEBUG - No user exists, redirecting to setup

[Admin9705]

ok that's good to know. i'll push this in the next version

[Admin9705]

@vipergts450 8.1.0+ should have the fix

[vipergts450]

Unfortunately not @Admin9705 :(

Same redirect issue where it is missing the /base_url/ before /setup in 8.1.1

I'll have to debug some of it myself.

[vipergts450]

From the log:

huntarr-1  | 2025-06-19 17:23:58 America/New_York - huntarr - DEBUG - No user exists, redirecting to setup
huntarr-1  | 2025-06-19 17:23:58 America/New_York - huntarr - DEBUG - Redirecting to setup with base URL: /setup

I think there's a circular logic problem in this code in auth.py

 ...
        # Get the base URL from settings to ensure proper subpath redirect
        try:
            from src.primary.settings_manager import get_setting
            base_url = get_setting('general', 'base_url', '')
            if base_url and not base_url.startswith('/'):
                base_url = f'/{base_url}'
            if base_url and base_url.endswith('/'):
                base_url = base_url.rstrip('/')
            setup_url = f"{base_url}/setup" if base_url else "/setup"            setup_url = f"{base_url}/setup" if base_url else "/setup"
 ...

1. If a user does not exist, they should be redirected to /setup route.
2. Redirect code above checks for a setting that would have been set up in setup and is not yet initialized
3. Redirect goes to /setup without the base_url

I think you should check for a BASE_URL environment variable right after the point where you are checking settings to see if it also exists there.

If it's already in settings and is not a blank string, use that one. If it's not, check if the user set a BASE_URL in ENV and try that.

# Get the base URL from settings to ensure proper subpath redirect
        try:
            from src.primary.settings_manager import get_setting
            base_url = get_setting('general', 'base_url', '')
            if not base_url:
                logger.debug(f"Base URL in settings db is empty, checking if BASE_URL environment variable was set")
                try:
                     base_url = os.environ.get('BASE_URL')
                except KeyError:
                     logger.debug(f"BASE_URL environment variable is not set")
                     base_url = ""
            if base_url and not base_url.startswith('/'):
                base_url = f'/{base_url}'
            if base_url and base_url.endswith('/'):
                base_url = base_url.rstrip('/')
            setup_url = f"{base_url}/setup" if base_url else "/setup" 

The assumption here would be that the very first user on a new install is admin and would set up the base_url variable for any/all future users on that first install.

[Admin9705]

try this - BASE_URL=${BASE_URL:-} in 8.1.2 (when released) again thanks for all the helpl