diff --git a/README.md b/README.md index a2c9eb97..cdc375c9 100644 --- a/README.md +++ b/README.md @@ -142,79 +142,8 @@ Refer to [PLUGINS.md](PLUGINS.md) if you would like to write a plugin. Troubleshooting -------- +Please see the [Troubleshooting](https://github.com/EDCD/EDMarketConnector/wiki/Troubleshooting) wiki page. -### App repeatedly opens the Frontier authentication website -The authentication didn't complete correctly for some reason. This can be caused by: - -- Using Internet Explorer. IE is [known](https://blogs.msdn.microsoft.com/ieinternals/2011/07/13/understanding-protocols/) to be broken. Please (temporarily) set your default browser to Edge, Chrome or Firefox and retry. -- The Frontier authentication website is confused - see [Error: An error occured](#error-an-error-occured). -- Entering credentials for a different Cmdr - see [Error: Wrong Cmdr](#error-wrong-cmdr). -- Entering Steam credentials instead of Frontier credentials - see [Error: User not found](#error-user-not-found). - -### Error: Invalid Credentials -See [above](#app-repeatedly-opens-the-frontier-authentication-website). - -### Error: An error occured -The Frontier authentication website is confused. Visit the [Frontier authentication website](https://auth.frontierstore.net/), log in and deauthorize "Elite Dangerous Market Connector". Then restart the app. - -### 500 internal server error -Either: - -- You pressed the "Approve" button on Frontier's authentication website twice. This is harmless; if the app isn't displaying any error messages and isn't redirecting again to Frontier's authentication website then all is fine. -- Frontier's authentication website sometimes gets overloaded and displays this error. Please try again later. - -### Error: User not found -Your Steam account may not be linked to your Frontier account (you can check whether you have any external accounts linked on the [Frontier store](https://www.frontierstore.net/frontier_partnerkeys/)). - -Please enter your Frontier credentials into the authentication website, not your Steam credentials. - -### Doesn't auto-update and/or persistently gives “Server is lagging” error -This app uses Elite: Dangerous' log files to track the systems and stations that you visit. If you're running this app on a different machine from the Elite: Dangerous game, or if you find that this app isn't automatically tracking the systems that you visit and/or isn't automatically “updating” on docking (if you have that option selected), then adjust the “E:D journal file location” setting on the Configuration tab to point to the game's log files. - -The default location is typically: - -- Windows: `C:\Users\you\Saved Games\Frontier Developments\Elite Dangerous` -- Linux Steam Play: `~/.steam/steam/steamapps/compatdata/359320/pfx/drive_c/users/steamuser/Saved Games/Frontier Developments/Elite Dangerous` -- Linux Wine: `~/.wine/drive_c/users/you/Saved Games/Frontier Developments/Elite Dangerous` - -### Credentials settings are greyed out -You won't be redirected to Frontier's authentication website and can't edit your EDSM or Inara credentials if: -- Elite: Dangerous is at the Main Menu. You will be able to edit these values once you've entered the game. -- The last time you ran Elite: Dangerous you didn't enter the game. You will be able to edit these values once you've entered the game. -- Your “E:D journal file location” setting is incorrect. See [above](#doesnt-auto-update-andor-persistently-gives-server-is-lagging-error). - -### Error: Wrong Cmdr -The Frontier server that supplies data to this app is supplying data for a different Cmdr than the one that you're currently playing. You are redirected to Frontier's authentication website and prompted again for your username and password. Either: - -1. You have multiple accounts and the username/password setting is not for the account that you're currently playing; or -2. You have reset your Cmdr but Frontier's server is still supplying data for the old Cmdr. - -If 1 check your username/password settings. - -If 2 this problem may or may not resolve itself in time. - -### I run two instances of E:D simultaneously, but I can't run two instances of EDMC -EDMC supports this scenario if you run the second instance of E:D in a *different* user account - e.g. using `runas` on Windows. Run the second instance of EDMC in the same user account as the second instance of E:D. - -EDMC doesn't support running two instances of E:D in the *same* user account. EDMC will only respond to the instance of E:D that you ran last. - -### I forgot to run the app - is there a way to process the missing data? -EDMC only processes live data from E:D. But you can upload your [journal](#doesnt-auto-update-andor-persistently-gives-server-is-lagging-error) file(s) for the missing period to [EDSM](https://www.edsm.net/en/settings/import/journal) and [Inara](https://inara.cz/settings/). - -### Error: Can't connect to EDDN -EDMC needs to talk to eddn.edcd.io on port 4430. If you consistently receive this error check that your router or VPN configuration allows port 4430 / tcp outbound. If using a proxy add `eddn.edcd.io` to the exemption list, plus `www.edsm.net` and/or `inara.cz` if using EDSM and/or Inara integration. - -### Import failed: No ship loadout found -Complex ship loadouts with Engineers' mods can cause you to hit an Internet Explorer / Edge limitation on the length of URLs. Switch to a browser that doesn't suck. - -### Very long "cooldown" period -You'll see a very long cooldown period if your system's time of day changes while you're running the app. To fix this: - -- Quit the app. -- Double-check your system's Date and Time settings. -- Windows: Run the RegEdit program and locate and delete the key `HKEY_CURRENT_USER\Software\Marginal\EDMarketConnector\querytime`. -- Mac: Copy and paste the following into a Terminal app window: `defaults write uk.org.marginal.edmarketconnector querytime -int 0` and press Enter. -- Re-start the app. ### Update Error! The [GitHub server](https://github.com/EDCD/EDMarketConnector/releases/latest) that hosts this app's updates only supports TLS 1.2 and higher. Follow [these](https://help.passageways.com/hc/en-us/articles/115005183226-How-to-enable-TLS-1-2-in-Internet-Explorer-11-and-MS-Edge) instructions to change your Windows settings to disable the [deprecated](https://tools.ietf.org/html/rfc7568) SSL 2.0 and 3.0 protocols and enable TLS 1.2.