# Sync for Reddit (iOS) custom server configuration

As of Sync for Reddit (iOS) 0.1 beta 44 (released 2023-06-12), a custom configuration can be used to point Sync to a different primary content server (API).

This is largely unsupported and experimental, but should work if the new API functions like the Reddit API.

---

Three pieces of information are needed: The unauthorised base URL, the authorised (OAuth) base URL, and the app's client ID.

* The default unauthorised base URL is `https://www.reddit.com`. This is used for share links, logging in, and refreshing the auth token.
* The default authorised base URL is `https://oauth.reddit.com`. This is used for OAuth calls after a token has been retrieved.

The base URLs must contain only the scheme (HTTPS) and the hostname. Any path, query string, etc. are not supported.

To set these values, navigate to Settings > General: Data Options > Server.

---

Alternatively, these values can also be set by opening a deep link.

Works:
* redditsync://set-server?baseURL=https%3A%2F%2Fcustom.server.com&oauthURL=https%3A%2F%2Foauth.custom.server.com&clientID=Super%20Client%20ID

Invalid base URL:
* redditsync://set-server?baseURL=some%20custom%20server&oauthURL=https%3A%2F%2Foauth.custom.server.com%2Fblah%2Fblah&clientID=Super%20Client%20ID

You can reset the server configuration to the default: redditsync://reset-server

---

After setting (or resetting) the custom configuration, the app should be restarted (killed) and relaunched to take effect.

---

While this is largely unsupported, feel free to let me know about issues with this on sync@devify.dk, providing as many details as possible so I can try to reproduce it and fix it.

Thanks,
u/MrJules