Bug: Fresh Docker installation fails on first access with `unexpected keyword argument 'text'`

#536 ยท closed ยท 6 comments

View on GitHub โ†—

daniiiol

## Bug: Fresh Docker installation fails on first access with `unexpected keyword argument 'text'` <img width="1730" height="354" alt="Image" src="https://github.com/user-attachments/assets/17aae018-4e6a-4081-8c4e-a885f5bea48d" /> ### Environment * Installation method: Docker Compose * Followed the commands from the Getting Started documentation: ```bash curl -O https://raw.githubusercontent.com/infobyte/faraday/master/docker-compose.yaml docker compose up -d ``` ### Description After starting the stack, all containers come up successfully and report a healthy status. However, on the very first access to the web interface, the application throws an exception and the page fails to load. ### Error ```text 2026-06-12T15:54:49+0000 - faraday.server.app - ERROR {Dummy-4} [pid:48] [app.py:1744 - log_exception()] Exception on / [GET] Traceback (most recent call last): File "/src/.venv/lib/python3.11/site-packages/flask/app.py", line 2529, in wsgi_app response = self.full_dispatch_request() File "/src/.venv/lib/python3.11/site-packages/flask/app.py", line 1825, in full_dispatch_request rv = self.handle_user_exception(e) File "/src/.venv/lib/python3.11/site-packages/flask/app.py", line 1823, in full_dispatch_request rv = self.dispatch_request() File "/src/.venv/lib/python3.11/site-packages/flask/app.py", line 1799, in dispatch_request return self.ensure_sync(self.view_functions[rule.endpoint])(**view_args) TypeError: create_app.<locals>.index() got an unexpected keyword argument 'text' ``` ### Steps to Reproduce 1. Download the Docker Compose file from the repository: ```bash curl -O https://raw.githubusercontent.com/infobyte/faraday/master/docker-compose.yaml ``` 2. Start the stack: ```bash docker compose up -d ``` 3. Wait until all containers report healthy. 4. Open the Faraday web interface in a browser. 5. Observe the exception above. ### Expected Behavior The initial page should load successfully after a fresh installation. ### Actual Behavior The application throws a `TypeError` on the first GET request to `/`. ### Additional Question Has anyone recently tested a fresh installation from scratch?

Comments

BekTim

Hi, is this still available? I'd like to pick this up for my first contribution.

daniiiol

I don't think anyone has had a chance to look at it over the weekend yet. I'd definitely be happy if someone picked it up. It's a bit unfortunate when the Quick Guide's first lesson is an error message. ๐Ÿ˜‡

BekTim

Hi @daniiiol I've just opened a PR #537 with the fix for this. I added the text=None default argument to the index function in app.py. This ensures it properly handles the initial Flask routing without throwing the TypeError. I tested it locally with a fresh Docker Compose installation, and the UI loads perfectly now. Let me know if everything looks good or if any adjustments are needed. Thanks again for letting me pick this up for my first open-source contribution!๐Ÿ˜Š

BekTim

Hey @daniiiol @nahwar Can you check my last commit, please? Thanks!

daniiiol

Hey @BekTim I just successfully tested the updated version locally as well. ๐Ÿ‘ Thanks so much! I'm looking forward to the upcoming release! ๐Ÿ˜‡

quentingosset

Thanks i will wait too :)