Known Issues on Mac OS X#

• If you can’t access Structr on Mac OS X (404 error when accessing http://localhost:8082/structr/), please remove the *.sources.jar and *.javadoc.jar from the main directory and restart. There should be a subdirectory named structr.

  Explanation: The start script tries to extract the static components of the backend UI from the main jar file to a folder structr/. Under certain circumstances, the extraction fails due to a bug in the script. The bug was resolved in January 2015, so any version built prior to this date seems to be affected.

  You can workaround by either removing or renaming the jar files containing sources and javadoc, or simply extract the static resources manually with the following command:

  jar -xvf structr-ui-<version>.jar structr/

• If you get the error message “start” can’t be opened because it was not downloaded from the Mac App Store, you need to adjust your GateKeeper settings. In principle you only need to go to Apple menu > System Preferences… > Security & Privacy > General and set Allow applications downloaded from to Anywhere

  For more information, please refer to the official Apple GateKeeper documentation

• If your neo4j installation (and by extension structr) crashes with the error message Too many open files, you need to add the JVM parameter -XX:-MaxFDLimit to bump the allowed number of open files to the maximum