Starting jFed on OS X ---------------------- On OS X, you need two things to run jFed succesfully: * Java 8 (the default Java versions installed by Apple, is Java 6), see :ref:`recent version of Java JRE ` * In recent OS X versions, you may also need to lower security settings, which depends when you use Firefox (:ref:`change-osx-security`) or Safari (:ref:`change-safari-security`). .. _install-jre: Installing the Java 8 JRE +++++++++++++++++++++++++ You need to have a recent version of Java 8 JRE installed on your Mac. You can verify which version is currently installed on http://www.java.com/verify. .. figure:: _static/images/mac/mac-verify-jre.png :align: center :width: 400 Verified Java JRE 8 installation If your computer fails the verification, you can download the most recent Java 8 JRE from http://www.java.com, as shown in the screenshots below. .. figure:: _static/images/mac/install-jre/mac-install-jre1.png .. figure:: _static/images/mac/install-jre/mac-install-jre2.png .. figure:: _static/images/mac/install-jre/mac-install-jre3.png .. figure:: _static/images/mac/install-jre/mac-install-jre4.png .. figure:: _static/images/mac/install-jre/mac-install-jre5a.png .. figure:: _static/images/mac/install-jre/mac-install-jre5b.png .. figure:: _static/images/mac/install-jre/mac-install-jre5c.png .. _change-osx-security: Changing OS X Security Settings (needed for Firefox, not for Safari) ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ By default, OS X does not allow applications outside of the App Store (such as jFed) to run. This causes the error ``"jfed-exerimenter.jnlp" can't be opened because it is from an unidentified developer.`` to appear. .. figure:: _static/images/mac/blocked/mac-blocked-unknown-developer.png You can change this setting by following these steps: 1. Open ``System Preferences`` .. figure:: _static/images/mac/blocked/mac-blocked1.png 2. Open ``Security & Privacy`` .. figure:: _static/images/mac/blocked/mac-blocked2.png 3. Unlock your settings by clicking on the lock in the bottom-left corner 4. Change ``Allow apps downloaded from:`` to ``Anywhere`` .. figure:: _static/images/mac/blocked/mac-blocked3.png 5. Click ``Allow from anywhere`` in the confirmation popup .. figure:: _static/images/mac/blocked/mac-blocked4.png .. _change-safari-security: Changing Safari Security Setting (Safari only) +++++++++++++++++++++++++++++++++++++++++++++++ By default, Safari sandboxes Java applications and doesn't give them permission to access the filesystem. This causes jFed to fail, as it needs disk access to access your user certificate. .. figure:: _static/images/mac/safari/mac-safari-jfed-error.png :align: center When you encounter problems starting jFed, you can explicitly allow filesystem access by following these steps: 1. Open Safari's ``Preferences`` .. figure:: _static/images/mac/safari/mac-safari1.png 2. Go to the tab ``Security`` and open ``Manage Website Settings..`` .. figure:: _static/images/mac/safari/mac-safari2.png 3. Change the setting for ``jfed.iminds.be`` from ``Allow`` to ``Run in Unsafe Mode```. .. figure:: _static/images/mac/safari/mac-safari3.png .. figure:: _static/images/mac/safari/mac-safari3a.png 4. Click ``Trust`` in the confirmation popup .. figure:: _static/images/mac/safari/mac-safari3b.png .. figure:: _static/images/mac/safari/mac-safari3c.png