Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Google Authentication

  • Link a Google account to a Kanboard user profile.
  • Show Google Avatar image.


  • Frédéric Guillot
  • License MIT



You have the choice between 3 methods:

  1. Install the plugin from the Kanboard plugin manager in one click
  2. Download the zip file and decompress everything under the directory plugins/GoogleAuth
  3. Clone this repository into the folder plugins/GoogleAuth

Note: Plugin folder is case-sensitive.


Installation instructions

Setting up OAuth 2.0 in Google Developer Console

  • Follow the official Google documentation to create a new application
  • In Kanboard, you can get the redirect url in Settings > Integrations > Google Authentication

Setting up Kanboard

There are two different methods to configure Kanboard:


  1. The easiest way is to copy and paste the Google Client credentials in the form Settings > Integrations > Google Authentication.
  2. Or add the credentials in your custom config file

If you use the second method, use these parameters in your config.php:


// Google client id (Get this value from the Google developer console)

// Google client secret key (Get this value from the Google developer console)

Automatic account creation

  1. As administrator, enable the account creation in Settings > Integrations > Google Authentication
  2. If you are using Google Apps for Work, you can allow only your own domain name to avoid unwanted people
  3. People just need to click on link "Login with my Google Account" on the login page to create a new account


  • If you don't apply any domain restriction, everybody with a Google Account will be able to sign-up
  • The local part of the email address is used to generate Kanboard's username
  • Users created by this way will be marked as remote user and the login form will be disabled for them (no local password)

Procedure to link a Google Account

  1. Go to your user profile
  2. Click on External accounts
  3. Click on the link Link my Google Account
  4. You are redirected to the Google Consent screen
  5. Authorize Kanboard by clicking on the button Accept
  6. Your account is now linked

Now, on the login page you can be authenticated in one click with the link Login with my Google Account.

Your name and email are automatically updated from your Google Account.


Kanboard uses these information from your Google profile:

  • Full name
  • Email address
  • Google unique id

The Google unique id is used to link together the local user account and the Google account.

To disable the Google Avatar go to your user profile > integrations, and change the value of the checkbox.