nasa/fprime

FPrime GDS - Provide a Base URL/ Root URL option so that its easy to reverse proxy FPrime GDS

Open

#3854 opened on Jul 7, 2025

View on GitHub
 (3 comments) (0 reactions) (0 assignees)C++ (9,718 stars) (1,249 forks)batch import
F´ GDShelp wanted

Description
F´ Version
Affected Component GDS

Feature Request: Configurable Base URL for GDS

Currently, FPrime's Ground Data System (GDS) can only run at a root URL (e.g., localhost:5000). This makes managing multiple FPrime instances challenging, requiring users to remember and track individual port numbers.

It would be helpful if GDS allowed specifying an arbitrary base URL (e.g., localhost/fprime-gds-2). This capability would simplify management of multiple GDS instances and facilitate use behind reverse proxies, similar to Grafana's root URL option. This is especially useful in a dockerized setup/as part of CI/CD pipelines.

Contributor guide

Tech stack
pythonflask
Domain
backend
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Python basicsFlask routingBasic understanding of reverse proxy
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
55
Research direction
The GDS likely uses Flask's url for or hardcoded paths. To implement a configurable base URL, one can add a configuration variable (e.g., BASE URL) and prepend it to all routes or use Flask's dispatcher middleware. The main server file (likely gds cli.py or similar) should parse a command line argument or environment variable. Also ensure that static file references in the frontend (HTML/JavaScript) use the base URL. Review existing configuration handling in the repository's GDS component and consider using Werkzeug's ProxyFix middleware for proper reverse proxy support.