How can we help you today?

Go ahead and ask us anything.

See the KanBo newest version.

KanBo Installation OnPremise Sharepoint 2013/2016/2019

Last modified:

1. Prerequisites


    • You can see the prerequisites which need to be fulfilled for the KanBo On-Premise installation in the following article.
    • Please request the latest KanBo Installation Files at


    You should choose the SharePoint Web Application where the most content (like Documents) is stored within your SharePoint Farm to create a new Site Collection from the Team Site Template inside of it. That way KanBo will be able to reuse most of your existing information without duplicating content.

    2. Assumptions

    For this installation example we are using the following:

    • URL for KanBo will be like the following: https://kanbo.kdomain12.local
    • Installation Directory for the KanBo Installation: "c:\kanboroot\kanboapp"
    • IIS Site Name: kanboapp
    • IIS App Pool Name: kanboapppool
    • Hostname: kanbo.kdomain12.local
    • SSL Certificate issued for: kanbo.kdomain12.local
    • Sharepoint Site Collection URL:
    • SSL Certificate is already installed properly on the IIS where KanBo will be installed

      3. Configure IIS

      3.1 First, we need to create an App Pool in IIS, which will be connected then with the Site which will be created for KanBo

      • Open your Internet Information Services (IIS) Manager
      • Right Click on "Application Pools" and click on "Add Application Pool"

      Image 12578

      • Name the Application Pool "kanboapppool" and click ok

      Image 12579

      3.2 Now we need to create a new Site to host the Kanbo Installation

      • In IIS Manager - Right Click on "Sites" and then click on "Add Website"

      Image 12581

      • Choose "kanboapp" as Site Name
      • Choose the "kanboapppool" Application Pool
      • Put the path where you want to have the KanBo Installation located (Here we are using "c:\kanboroot\kanboapp")
      • Choose "https"
      • Put in your hostname (we are using "kanbo.kdomain12.local" in our example)
      • Mark "Require Server Name Indication"
      • Choose your SSL Certificate
      • And click ok

      Image 12567

      3.3 In the next step we will configure the Authentication Levels
      • In IIS Manager, click on your KanBo Site
      • Then Open on the right side "Authentication"

      Image 12831

      • Configure - on the Site Level - as follows:
        • Anonymous Authentication -> "Enabled"
        • Windows Authentication -> "Disabled"

      Image 12852

      3.4 Now we need to configure also on the Site Level

      • Click on your site (kanboapp) - Auth - ntlm
      • On the right side click on "Authentication"

      Image 12829

      Configure - on the site level - as follows:
      • Anonymous Authentication -> "Disabled"
      • Windows Authentication -> "Enabled"

      Image 12853

      3.5 Last Step in IIS is to unlock Sections in Configuration Editor on both server and site level
      • First Click on your Server again and on the right side open the "Configuration Editor"

      Image 12571

      • Now choose the Section System.webServer/security/authentication
      • Click on "anonymousAuthentication" - then click on "Unlock Section" on the right side
      • Then click on "windows Authentication" - then click on "Unlock Section" on the right side

      Image 12577

      • Then click on your Site "kanboapp" and on the right side open the "Configuration Editor"

      Image 12573

      • Now choose again the Section System.webServer/security/authentication
      • Click on "anonymousAuthentication" - then click on "Unlock Section" on the right side
      • Then click on "windows Authentication" - then click on "Unlock Section" on the right side

      Image 12529

      neuer punkt 4 sitecollection erstellen - mit satz von oben plus erstellung von site collection beschreiben

      4. Register a new App Identifier in Sharepoint

      To register a new App Identifier open the following link (replace the part in yellow with your own URL, where your Sharepoint App Catalog is located):

      1. Click on Generate Client id
      2. Click on Generate Client secret
      3. Fill in the Title: KanBo
      4. As App Domain, fill in: kanboapp.kdomain12.local
      5. As redirect URL fill in: https://kanboapp.kdomain12.local
      6. And click on "Create"

      Image 12574

      • You will see a confirmation with details - Please save the results for later usage

      Image 12586

        5. Set Permissions on the KanBo Installation directory

        KanBo needs some additional permissions, therefore, please 

        • Add the following Users with read access to the kanbo Installation directory (here it is: c:\kanboroot\kanboapp\)
          • "IIS_IUSRSUser"
          • "Authenticated Users"
          • "IIS APPPool\kanboapppool"

        6. Register the (Self-Signed) Certificate in SharePoint

        • Please change the data in yellow and run the script in Powershell Console:
        Add-PSSnapin Microsoft.SharePoint.PowerShell
        $publicCertPath = "<span style="background-color: rgb(255, 255, 0);">C:\location-to-your-certificate\kanbo-certificate.cer</span>" $certificate = New-Object System.Security.Cryptography.X509Certificates.X509Certificate2($publicCertPath) New-SPTrustedRootAuthority -Name "<span style="background-color: rgb(255, 255, 0);">kanbo-certificate.cer</span>" -Certificate $certificate $realm = Get-SPAuthenticationRealm $specificIssuerId = "<span style="background-color: rgb(255, 255, 0);">FEB88A0921B-AE9A-2256-9B466A5D4CD5F</span>" $fullIssuerIdentifier = $specificIssuerId + "@" + $realm New-SPTrustedSecurityTokenIssuer -Name "ContosoAppsHighTrust" -Certificate $certificate -RegisteredIssuerName $fullIssuerIdentifier -IsTrustBroker iisreset;

        7. Install KanBo

        In this step we are going to install KanBo in the Site directory - which means to only copy/extract the files from the zip file to the KanBo Site directory, which you did choose in IIS (here we are using "c:\kanboroot\kanboapp\") and then we need to configure the settings in the web.config file.

        7.1 Extract the KanBo Installation Files from the zip file which has been provided to you into the root directory of your kanbo installation "c:\kanboroot\kanboapp\"

        Image 12584

        7.2 Configure the web.config

        Please open the web.config file in an editor (it is located in the root of your kanbo site) and configure as follows in the auth.sharepoint section

        Image 12585

        • Spaddress is
        • Clientid is the one from the step before
        • Issuer id is registeredissuername - first part, only until @
        • Thumbprint is thumbprint from wildcard cert
        • Or path to pfx and password

        Image 12575

        • Enter Sql connectionstring (Preferable SQL Authentication)

        Image 12576

        8. Distribute the app in Sharepoint

        To be able to distribute the KanBo App, we need to customize the file appmanifest.xml at first, therefore you need to do the following:

        • Locate the file
        • And just rename the file to (only the extension needs to change to zip)
        • Then open the file and locate the file appmanifest.xml and copy it out of the zip file (choose any location on your PC)
        • Then open the file appmanifest.xml (which you did extract before) in an editor and modify only the following parts:
          • the Domain
          • the ClientID

        Image 12535

        • After modifying, save the appmanifest.xml file
        • Then just locate it in your explorer and drag and drop it to your file
        • You will be asked if you want to overwrite, plese confirm that and the file will be included in the zip file then correctly
        • Then rename back again the file to (again only change the extension from "zip" to "app")

        Now we are going to distribute the kanbo app in sharepoint, which we will do in the App Catalog - you can go there like this

        • Go to Sharepoint Central Administration
        • Click on "Apps" in the left menue
        • Click on "manage app catalog"
        • Click on the url which shows up from your app catalog (
        • In your app Catalog Click "Distribute apps for sharepoint"
        • Then click on "upload"
        • Browse/Select the (which we prepared in the step before) and Click ok
        • The app will be loaded and listed then

        9. Add the app to sharepoint

          After the KanBo app is distributed in the Sharepoint App Catalog, we can add it to our apps.

          • Open your Sharepoint Page, where you want to add KanBo (here we use:
          • Click on the top right on the gear Symbol and in the menue click on "add an app"

          Image 12587

          • You will see a list of available applications, where also KanBo will show up
          • Click on KanBo - it will show that you cannot add this app here (which is because at first, you need to request the permission for this app)
          • Click on "find out why"

          Image 12537

          • In the next window, Click on "request approval"

          Image 12538

          • In the pop up window click on the "request" button

          Image 12539

          • The App request is now pending  (it will show you then pending permission)

          Image 12540

          Image 12541

          • In the next window, click on approve

          Image 12542

          •  The KanBo App is now approved

          Image 12543

          • Now, as the KanBo App did get the permission, we can install it
          • Therefore go back again to
          • Click on the top right, on the gear Symbol
          • Click on add an app
          • Then Click on the kanbo app
          • And click then on "trust it"

          Image 12544

          10. Run KanBo Setup

          Now we can run the KanBo Setup by opening the page: https://kanbo.kdomain12.local/setup and follow the steps from the setup instructions

            Is this article helpful for you?