What you need
- A Bluesky account.
- An App Password created in Bluesky settings (not your normal login password).
- Your handle and the PDS service URL (almost always
https://bsky.social).
Get your credentials
Handle handle (required)
This is your full Bluesky name including the domain, like yourname.bsky.social — or a custom-domain handle such as blog.example.com if you've configured one. You'll see it on your profile or under Settings; it's whatever follows the @. Type it in without the @.
App password app_password (required)
This is a separate, revocable password so you never have to hand over your real one. To make one, sign in at https://bsky.app/, go to Settings → Privacy and Security → App Passwords → Add App Password (shortcut: https://bsky.app/settings/app-passwords), name it something like "MokonyxSocial", and copy the xxxx-xxxx-xxxx-xxxx password it generates. It only shows once, so grab it — dashes and all.
Service URL service_url (required)
This is your Personal Data Server (PDS) address. If you're on the regular Bluesky network, it's https://bsky.social. Only change it if you self-host a PDS or your account lives on a third-party one. Unsure? Use https://bsky.social.
Set it up in MokonyxSocial
- In Joomla admin, go to Components → MokonyxSocial → Services → New.
- Choose Bluesky.
- Enter the credentials above.
- Click Send Test to check it, then Save & Close and make sure it's Published.
Verify
Once Send Test goes green, check your Bluesky feed for the test post. After that, publishing a Joomla article should drop a matching post with a link card.
Troubleshooting
- "Invalid identifier or password"? You probably left an
@on the handle, or used your main password — make an App Password and re-enter the handle without the@. - "Could not resolve handle"? Your
service_urldoesn't match your account's PDS — the default ishttps://bsky.social. - Post rejected as too long? You're over 300 characters — shorten your template.
- Rate limited? Bluesky throttles fast posting; spread your publishes out.
Notes & limits
- Hard cap of 300 characters per post.
- Link cards come from the shared URL's Open Graph tags, so running MokonyxOpenGraph alongside gives you nicer previews.
- You can revoke an App Password anytime without touching your main password.
- Images can attach but must fit Bluesky's size and count rules.
