Skip to content

Add troubleshooting for blocked hosts error #108

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
neolefty wants to merge 1 commit into
base: development
Choose a base branch
from
Open

Add troubleshooting for blocked hosts error #108

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions docs/develop/Install/Development/Docker/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -140,4 +140,18 @@ To fix this you may follow [Post-installation steps for Linux](https://docs.dock

* This can happen after `docker compose build`; clear your browser cookies for that page and try again.

### "Blocked hosts" error when accessing TaxonWorks with custom hostname

* Problem: When accessing TaxonWorks using a custom hostname (e.g., `taxonworks.local` or `taxonworks.yourdomain.com`), you see a "Blocked hosts" error page.
* Solution: Configure allowed hosts in `config/application_settings.yml`:
1. Create the file `config/application_settings.yml` in your TaxonWorks directory (this file is git-ignored)
2. Add your custom hostname(s) to the allowed hosts list:
```yaml
allowed_hosts:
- taxonworks.local
- taxonworks.yourdomain.com
```
3. Restart the Docker containers with `docker compose down` followed by `docker compose up`
* Note: This is a Rails security feature that prevents DNS rebinding attacks. The default configuration allows `localhost` and `127.0.0.1`, but custom hostnames must be explicitly allowed.