Skip to content

Installation and Updates

Ellis Tsung edited this page Apr 23, 2018 · 3 revisions

Installation

Safari Extension Gallery

The preferred method of installation is to install from the extension gallery. This allows the extension to update automatically, and the submissions are approved by Apple. However, updates will be delayed due to the approval process.

Manual Installation

This method is more prone to error and does not offer manual updates, but does allow you to install older versions (may need to uninstall existing version first to downgrade).

  • Download uBlock0.safariextz
  • Open the downloaded extension
  • At this point, you may be presented with a popup asking if you want to install from the Gallery
    • To continue installing manually, click Install from Developer
  • In final Safari popup:
    • Click Trust

Troubleshooting

If clicking Trust does not work, you may need to use keyboard controls:

  1. Launch System Preferences and open the Keyboard pane.
  2. Switch to the Shortcuts tab.
  3. Toggle All Controls to selected.
  4. Re-attempt to install the extension and use the Tab key on the keyboard to highlight Trust.
  5. Press the Space bar key to press the Trust button once selected.

Updating

Before updating, I recommend backing up uBlock settings if possible, just in case.

Automatic Updates

If you installed the extension through Safari's Extension Gallery, then make sure that you have Automatically update extensions from the Safari Extension Gallery checked at the bottom of Safari > Preferences > Extensions. Just note that due to Apple's approval process, automatic updates may arrive weeks after a new release is published on Github.

Manual Updates

Shortly after a release is available for download, you can easily update to it manually through Safari.

  • Safari > Preferences
  • Select the Extensions tab
  • Select Updates (see screenshot below)
  • Click update

Alternatively, you can perform a manual installation of the newer version.

Extension Updates Screenshot