mirror of
https://github.com/AppFlowy-IO/AppFlowy.git
synced 2026-03-24 12:56:59 +00:00
[GH-ISSUE #8358] [Bug] Admin Console error "Unable to connect to server" when using FQDN=localhost in Docker Compose #3760
Labels
No labels
2024
2025
2026
acct mgmt
AI
automation
bug
calendar
ci
CJK
cloud
code-block
collaboration
copy-paste
database
data migration
data sync
deploy
desktop
develop
develop
documentation
duplicate
editor
editor-plugin
emoji
export
files
flutter-only
follow-up
formula
good first issue for devs
good first issue for experienced devs
grid
hacktoberfest
HACKTOBERFEST-ACCEPTED
help wanted
i18n
icons
images
importer
improvements
infra
install
integrations
IR
kanban board
login
look and joy
mentorship
mobile
mobile
needs design
new feature
new feature
non-coding
notes
notifications
onboarding
organization
P0+
permission
platform-linux
platform-mac
platform-windows
plugins
program
pull-request
Q1 25
Q1 26
Q2 24
Q2 25
Q3 24
Q3 25
Q4 24
Q4 25
react
regression
rust
rust
Rust-only
Rust-only
Rust-starter
Rust-starter
self-hosted
shortcuts
side panel
slash-menu
sync v2
table
tablet
task
tauri
templates
tests
themes
translation
v0.5.6
v0.5.8
v0.5.9
v0.6.0
v0.6.1
v0.6.4
v0.6.7
v0.6.8
v0.7.1
v0.7.4
v0.7.4
v0.7.5
v0.7.6
v0.7.7
v0.7.8
v0.8.0
v0.8.4
v0.8.5
v0.8.9
web
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
AppFlowy-IO/AppFlowy#3760
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Originally created by @vagetablechicken on GitHub (Nov 26, 2025).
Original GitHub issue: https://github.com/AppFlowy-IO/AppFlowy/issues/8358
Bug Description
Ref tutorial, I
cp deploy.env .env, so it'll useFQDN=localhost, the admin frontend might fail to connect to GoTrue or other services, got errorUnable to connect to server. Please check your connection and try again.on admin console web.I had to switch localhost to my local LAN IP to get everything working properly.
FQDN=<my ip>Is this issue specific to macOS or OrbStack? If so, maybe we should add more comment about it, e.g. 'careful about FQDN', 'if localhost can't work, use lan ip'.
How to Reproduce
I deployed AppFlowy on macOS (OrbStack) following the official docs https://appflowy.com/docs/Local-Host-Deployment. I used the default configuration by copying deploy.env directly to .env.
Upon accessing the console at localhost:80/console, the frontend fails to connect to the backend with the error: 'Unable to connect to server.' It seems the default configuration might have issues communicating within the container environment.
Expected Behavior
Should login successfully.
Operating System
macos 15.5
AppFlowy Version(s)
latest
Screenshots
Additional Context
No response
@Zack-labs commented on GitHub (Dec 1, 2025):
same
@Zack-labs commented on GitHub (Dec 1, 2025):
I added this to .env; but still same error:
GOTRUE_VERSION=0.9.165
APPFLOWY_CLOUD_VERSION=0.9.165
ADMIN_FRONTEND_VERSION=0.9.165
APPFLOWY_WORKER_VERSION=0.9.165
APPFLOWY_WEB_VERSION=0.9.131
@james-agbonz commented on GitHub (Dec 2, 2025):
I am currently experiencing the same issue and sometimes a successful login is cached , but when i logout i have the same recurring error again
@Zack-labs commented on GitHub (Dec 2, 2025):
@vagetablechicken @james-agbonz
It worked yaaaaay
.envfile, replacelocalhostwith your machine’s IP address:httpinstead ofhttpsto avoid CORS/network issues.@JasZhe commented on GitHub (Dec 15, 2025):
For some reason I get a 200 response but with this, seems like there's supposed to be some sort of redirect maybe?
I changed the FQDN to point to the internal IP of my host machine (i.e. 192.168.x.x) and the custom nginx ports NGINX_PORT=4444 and NGINX_TLS_PORT=4445 as well as changing the docker compose mounts to be bind mounts. And port mappings for redis:
ports:
and for the gotrue:
ports:
all i see is an nginx log:
edit: resetting the nginx port to 80 and 443 seems to fix it..
edit2: 🤦 I had to add the custom nginx port to the FQDN i.e. 192.168.x.x:4444 and then I also had to allow the docker network through my firewall i.e.
docker network inspect appflowy-cloud_default-><subnet i.e. 172.16.16.0/24>->sudo ufw allow from<subnet i.e. 172.16.16.0/24>to any port 4444 proto tcp@tylerjwoodfin commented on GitHub (Dec 20, 2025):
@JasZhe 's solution worked perfectly for me, as well, after about 2 hours of troubleshooting this.
@Varssos commented on GitHub (Jan 14, 2026):
Issue is still visible.
@Zack-labs , @JasZhe , @tylerjwoodfin thank you guys.
In my case in
docker logs appflowy-cloud-admin_frontend-1I had:I only had to change in
.env:FQDN=<your_machine_ip>:<port>In my case it was(because I changed NGINX_PORT=4080):
FQDN=192.168.0.64:4080After that
docker logs appflowy-cloud-admin_frontend-1:@ediwon23 commented on GitHub (Jan 30, 2026):
I found a trick to fix this,
When I traced the error from
admin_frontendcontainer, which is "error. getaddrinfo ENOTFOUND domain.com"So I assume it is a DNS error, then add extra_hosts to
admin_frontendservice indocker-compose.ymlYou can find this ip from
docker inspect appflowy-cloud-nginx-1, then don't forget to apply the change bydocker compose up -d. After that, you could log in "http://youdomain.com/console" and create a user and password.As a result, I think the problem is that admin_frontend need to access nginx. But it can't if you didn't expose to public without DNS record.
@khanetor commented on GitHub (Feb 25, 2026):
I think I am seeing the regression of this issue, since I am using the latest admin frontend docker image.
I am using a domain name "appflowy.example.com", so I set the env var FQDN as such, instead of ip:port as mentioned above.
Then, when logging in the admin console, I can only see this
Checking the logs in different containers (10 containers in total), I can only see an error in the admin frontend container.
What I find interesting is the use of localhost. I think it is hard-coded somewhere, because I don't specify any env vars to localhost. When I sh into the admin frontend container, I can ping gotrue:9999 without problems, and the ping was not successful with localhost:9999.
In other instances, I also saw this error message randomly.
For completeness, here is the complete set of env var in my Dokploy deployment.
I have played around with APPFLOWY_ADMIN_FRONTEND_VERSION from 0.12.2 to 0.12.6, and they all behave the same way.
@x9t9 commented on GitHub (Mar 12, 2026):
Having the same issue ( deploying on Dokploy )
It seems to be an issue with http:// Vs. https:// config on the URL / Domains and DNS / FQDN for some redirects.
But honestly not sure yet
@erayerdin commented on GitHub (Mar 16, 2026):
I have reached to a new set of errors:
Basically, even if it is HTTP, it cannot set some cookies as secure as it is not HTTPS.