HybridAuth, Open Source Social-Sign-On Solution


A PHP Library for authentication through Facebook, Twitter, Google, Yahoo, MySpace, LinkedIn, FourSquare, OpenID and many other Identity providers

HybridAuth User guide » Install


Let's assume you have the following environment setup :
  1. Apache running at port 80
  2. PHP 5.2 installed with all the required dependencies (also we need cURL and SimpleXML for some providers)
  3. Server is accessed as www.mywebsite.com
  4. Document-root is accessed as /www/mywebsite.com

To install HybridAuth, you can use the Installer or do it manually :


1. Using HybridAuth Installer:

  1. Download the lastest stable release from sf.net
  2. Uncompress then put HybridAuth Library into your website Document-root. The complete path should be something like: /www/mywebsite.com/hybridauth/
  3. Go to http://www.mywebsite.com/install/index.php and follow the required steps described by the installer.
  4. Don't forget to delete the ("install") folder and all the files inside of it after you complete the installation
2. Manual Installation :

  1. Download the lastest stable release from sf.net
  2. Uncompress then put HybridAuth Library into your website Document-root. The complete path should be something like: /www/mywebsite.com/hybridauth/
  3. There is one and only one file usually accessed from outside, so set it to +rx mode (read and execute permissions):
    • index.php => http://www.mywebsite.com/hybridauth/index.php
  4. Make sure that HybridAuth temporary folder /www/mywebsite.com/temp/ is RECURSIVELY WRITABLE.
  5. Change $GLOBAL_HYBRID_AUTH_URL_BASE in hybridauth/hybridauth.php configuration file with the complete url to hybridauth library on your website.The complete URL should be something like: http://www.mywebsite.com/hybridauth/
  6. Set your applications keys on hybridauth/hybridauth.php file.
    Visit Supported identity providers section to know how to setup external Social Network Application Credentials.
  7. Visit http://www.mywebsite.com/hybridauth/examples/ to try some working demos.
  8. Don't forget to delete the ("install") folder and all the files inside of it after you complete the installation

    9. Please note: HybridAuth will not work properly in localhost, because the majority of social networks and identities providers 'IDps' DO NOT TRUST http://localhost/ requests,

Home - Overview - User guide - Blog - Contact - Contribute - Licenses - Credits - Similar projects