Skip to content

fix: correct Docker redirect URI port in provider docs (5000 -> 4007) - #258

Closed
thisismairaj wants to merge 1 commit into
gitroomhq:mainfrom
thisismairaj:fix/docker-redirect-uri-port
Closed

thisismairaj wants to merge 1 commit into
gitroomhq:mainfrom
thisismairaj:fix/docker-redirect-uri-port

Conversation

@thisismairaj

Copy link
Copy Markdown

Summary

Every provider's self-host doc lists the Docker OAuth2 redirect URI as http://localhost:5000/integrations/social/<provider>, but the official postiz-docker-compose setup (the one linked from the Quick Start) maps the app container to host port 4007, not 5000:

MAIN_URL: 'http://localhost:4007'
FRONTEND_URL: 'http://localhost:4007'
ports:
  - "4007:5000"

Port 5000 is only the container's internal port. A browser following the standard Quick Start setup can't reach localhost:5000 directly, so every provider's documented Docker redirect URI is unreachable as written, and registering the redirect URI exactly as documented fails during the OAuth callback.

Found this firsthand while self-hosting Postiz locally via postiz-docker-compose and registering a LinkedIn developer app for OAuth.

Changes

Updated the Docker: redirect URI line in all 17 affected provider docs (18 occurrences, Instagram has two) from localhost:5000 to localhost:4007, matching the official compose file. tumblr.mdx already had the correct port and was left untouched.

Test plan

  • Confirmed the actual port mapping in postiz-docker-compose's docker-compose.yaml ("4007:5000", FRONTEND_URL: 'http://localhost:4007')
  • Reproduced the mismatch live: self-hosted the stack, registered a LinkedIn app with the documented localhost:5000 URI, confirmed localhost:5000 isn't reachable from the host/browser
  • grep-verified no remaining localhost:5000 references across self-host/providers/

The official postiz-docker-compose setup maps the app to host port 4007
(docker-compose.yaml: "4007:5000"), matching MAIN_URL/FRONTEND_URL in
that same file. Every provider doc's "Docker" redirect URI example
instead showed localhost:5000, the container's internal port, which a
browser following the standard Quick Start setup can't actually reach.

Verified by self-hosting via postiz-docker-compose and hitting this
exact mismatch while registering a LinkedIn OAuth app.
@postiz-contribution

Copy link
Copy Markdown

Hi @thisismairaj! Thanks for the PR. Contributions to Postiz are gated behind an application. Please apply at https://contribute.postiz.com/p/postiz and we'll reopen this PR once you're approved.

Not sure what just happened? https://contribute.postiz.com/for-contributors

This project also requires a signed Contributor License Agreement. You can sign it now at https://contribute.postiz.com/p/postiz/cla so you're ready as soon as your application is approved.

@postiz-contribution postiz-contribution Bot added the contribution:pending Awaiting application review label Oct 14, 2026
@postiz-contribution

Copy link
Copy Markdown

Hi @thisismairaj! Your application for Postiz is awaiting review. We'll reopen this PR once it's approved. Status: https://contribute.postiz.com/p/postiz

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

contribution:pending Awaiting application review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant