Troubleshooting
If you are getting errors or need support this is the page for you.
PlatySync is built with NodeJS libraries, so if you are behind a corporate proxy and run into an error while running npm install, it is likely that npm can't reach the internet. You may need to set the http and https variables in the npm config file.
If you have forgotten or lost the password you login with, or the one used to initially to set up, you will need to reset PlatySync.
If you find an inconsistency within schemas/rules/etc, your options are:
- Refresh the page
Web apps can occasionally get out of sync. A refresh can sometimes fix things. - Logout
Force the app to reload your session by logging back in. - Use the Clear Cache option located on the settings screen
This button will clear the schema cache loaded on the server and reload the page. - Download the latest release
The bug/issue you are experiencing may have already been fixed in a new version. - Reset PlatySync
Use the Factory Reset option located on the settings screen
You can perform this task manually if all else fails. - Submit a bug report via github issues
Don't forget to include any relevant logs.
In the event you need to delete existing settings and 'factory reset' PlatySync, these are the instructions for you.
Locate the data directory for PlatySync (for windows this will be %appdata%\platysync) and delete the filed named database.sqlite.
This file contains application settings used by PlatySync, such as the initial password (encrypted).
Application settings are stored separately from the schema configuration files, meaning you should not loose anything important. Force-reload the application in the browser and you should be re-presented with the initial configuration screen. Set the new password and your schemas should be ready to go. You will also need to re-configure any custom application settings which were reset.
In the very unusual event you need to delete the key used by PlatySync to encrypt passwords, you will need to locate and delete the PlatySync entry on your platform's credential/keychain store. This key is stored and managed via the keyring package.
Warning: deleting this key will make make login impossible without deleting the sqlite database.
In Windows, you can find the key via Credential Manager:
There is a Log browser available via the sidebar.
For additional data, actual log files are located in the the data directory for PlatySync (for windows this will be %appdata%\platysync).
- general.txt
Logs related to general/generic software operations. - history.txt
Logs related to scheduling, rule evaluation and execution.