Installing Goosle on your server or on a localhost

Requirements

Any basic webserver/webhosting package with PHP7.4 or newer.
No special requirements other than APCu for caching (Optional).
Developed on Apache with PHP8.2.

Installation

  1. Download Goosle from Github.
  2. Unarchive the Goosle download
  3. In the main directory copy config.default.php to config.php.
  4. Edit the config.php file and set your preferences.
  5. Upload all files to your webserver. (eg. example.com or search.example.com or a sub-folder such as example.com/search/)
  6. Rename goosle.htaccess to .htaccess or add its contents to your existing .htaccess file.
  7. Load Goosle in your browser and follow the prompts.
  8. Set up a background task (Cronjob) as described below. This runs a background task to delete old cache files and renews authorization tokens and checks for updates.
  9. Let me know where you installed Goosle in the 'Show your Goosle' discussion on Github :-)

Installation and setup notes

  • When using file caching you should set up a cronjob to execute goosle-cron.php every few hours. This deletes cached results.
  • When you use Openverse for your image searches you should set up a cron job to execute goosle-cron.php every 11 hours or less. This will automagically renew the access token.
  • If you want update notifications in the footer of Goosle set up the cron job so Goosle can ping Github weekly to see what's new.
  • The .htaccess file has a redirect to force HTTPS, catch 404 errors with a redirect as well as browser caching rules ready to go.
  • The robots.txt has a rule to tell all crawlers to not crawl Goosle. But keep in mind that not every crawler obeys this file.
  • The access hash is NOT meant as a super secure measure and only works for surface level prying eyes.

Article Details

Related articles

More plugins and services

AdRotate Pro Single License
AdRotate Professional
Banner manager

Get started with successful advertisement campaigns on your WordPress and Classicpress website within minutes. Use features like Geo Targeting, scheduling and post injection to start making that passive income!
AJdG Solutions Plugins
All my plugins
WordPress and Classicpress

Check out my handy plugins for WordPress and Classicpress. Also take a look at these extensions for WooCommerce and bbPress and run your webshop and forum more efficiently!