How can we help you today?

Go ahead and ask us anything.

KanBo installation on Office 365 and Azure

Last modified:

Azure installation o365 Office365

Contact us at [email protected] to receive most recent KanBo installation package.


  1. KanBo installation package and
  2. Office 365 Enterprise E1 environment (or a higher version) and administrator access to it.
  3. Administrator access to Azure portal and a valid Azure subscription.
  4. One SQL Database on Basic: 5 DTU, 2 GB pricing tier created manually for the initial installation process (will be removed after the installation).
  5. Optional - having a custom domain and SSL certificate for your KanBo Web App (in case you would like to have your KanBo running at a custom address, not a default Azure address

(Important information - KanBo databases will be created automatically and charged on Azure during the final steps of installation process, hovewer you can change KanBo Content database pricing tier to recommended version for a certain number of KanBo users. See the details about recommended pricing tiers for databases in Configuring KanBo Content Database on Azure part of installation).

Creating the hosting site

Creating a Web App

First of all, we need to start with creating a new Web App on your Azure. It will be used to host the application.

Go to your Azure management page, click on +New and search for Web App.

Full KanBo installation on Office 365 SharePoint Azure Microsoft

Choose a Web App.

Full KanBo installation on Office 365 SharePoint Azure Microsoft

Click on "Create button".

Full KanBo installation on Office 365 SharePoint Azure Microsoft

Provide the name url of your site, in our case it will be "kanboinstallation".

Choose your Subscribtion, Resource Group (create new and name it "Kanbo") and choose the App Service plan/location. Select OS as Windows.

Configuring a Custom Domain and SSL certificate for Web App (Optional)

In case you would like to have your KanBo running on a custom domain and not at Azure default address (, you need to prepare the following:

Map an existing custom DNS name to Azure Web App

Bind an existing custom SSL certificate to Azure Web Apps

Follow the Microsoft Technet manuals above to set a custom domain and an SSL certificate to the Web App.

Configuring the new Web App

After the page has been created, we need to change some settings. Click on

Web Apps icon on the left pane and search for your application. Click on your page to navigate to its options.

After the page has loaded, scroll the menu down and click on the "Application settings". You will see the configuration screen, find the Web Sockets option and turn it on. Save your changes.

Registering the app within the Site Collection

Go to the site collection where you want to install KanBo and navigate to the following URL: {YourSiteCollectionURL}/_layouts/15/appregnew.aspx .

After navigating to the site click on both "Generate" buttons in Client ID and Client Secret.

In the title field enter "KanBo".

App domain should be the domain of the site we have created on Azure – in this example, it is .

The Redirect Uri should be the site address with the HTTPS prefix + /pages/default.aspx. In our case, it will be

(if you use a custom domain, add it to App Domain as yourkanbo.domain and https://yourkanbo.domain/pages/default.aspx)

After clicking "ok", you will be presented with the following page:

It is very important to save this information for later. Please copy all the data into a Notepad or any other text editor and save it.

Configuring the web.config file

Providing the ClientId and ClientSecret

Download the most recent KanBo installation package (contact us at [email protected] to receive it).

Extract the KanBo.Web package and open the web.config file provided in it.

After opening it, insert these entry to <plugins> before <loadPackages> section. Insertvalues of Client Id in {CLIENTID} and Client Secret in {CLIENTSECRET}. Also add a SharePoint URL in {SPHOSTURL} location.

     <auth-by-login issuer="sp" >
                <auth.sharepoint-online sp-host-url="{SPHOSTURL}" client-id="{CLIENTID}" client-secret="{CLIENTSECRET}" />
                <setup-permissions.sharepoint />

Moreover, remove entire section dedicated on-premise installation

<!-- <on premise> -->
      <provider id="sp" type="Sharepoint" sphosturl="{SPHOSTURL}" clientid="{CLIENTID}" issuerid="{ISSUERID}">
        <!-- signer is described below, this one must contain a private key -->
        <signer type="X509SignerFromStore" storename="My" storelocation="LocalMachine" key="Thumbprint" value="{Thumbprint}"></signer>
<!-- </on premise> --> 

Save your changes.

Add these entries to <plugins> section after <package name="standard "/>.

<website-search.sharepoint /> 
<sql sync-interval="100" />
<messaging track="single-node" queue-interval="1000" send-interval="1000" inactive-detect-interval="1000" />
 <user-location />

Creating an SQL database

Enter link to create an SQL Database.

The new database is only temporary as it is needed only to configure DB connectivity in the further steps of the installation. In the last step of the installation procedure, we will ask you to delete it - it will not be used.
You can name it "kanboinstallation_db" or use any other name. Please set the pricing tier to "Basic: 5 DTU, 2 GB", collation to SQL_Latin1_General_CP1_CI_AS and leave all other parameters as they are.

Click on Create to save your database.

Configuring the DB connectivity

Use the Azure portal to obtain the connection string necessary for your Web App to connect with Azure SQL Database:

Click on the SQL Databases icon and then, search for your temporary database.

Click on your database, then click Show database connection strings.

If you are going to use the ADO.NET connection library, copy the string of ADO.NET.

Go to the web.config file where we have previously entered the ClientId and ClientSecret. Search for <connectionstrings> section.

Paste the connection string there in the place of an old string. Please modify added connection string - add your user ID and password (use server admin's credentials).

Save the changes.

There are two important things:

a) Put "MultipleActiveResultSets=True" at the end of each connection string.

b) Find out a new Database name (ex. KanBoContent_db) so it is unique for the chosen database. (the name can't be the same as the name of the database we've created for the Azure site). Delete a previous name and replace it with new one.

Now you can delete the previously created temporary database (in our scenario it will be "kanboinstallation_db").

Uploading the KanBo installation package

You can do it in two different ways.

Option 1 - Use FTP

After all changes to the web.config have been made, save the file and upload the whole content of the .rar to the {yourAzureFTPRootFolder}/site/wwwroot/. ATTENTION: DO NOT DELETE EXISTING SITE STRUCTURE!

Full KanBo installation on Office 365 SharePoint Azure Microsoft

Option 2 - Use KUDU service

Navigate to your Azure website KUDU service (add .scm just before e.g, then select Debug console -> PowerShell).

Then enter site folder -> wwwroot.

Pack all your files into a .zip file (but please don't add the folder!)

Now drag and drop your .zip archive into the left upper part of KUDU service.

Modifying the file

Download the 

First of all change the extension of the to .zip so that it is When it is done, open the .zip file(do not extract it!) and open AppManifest.xml. It should be opened in a new window of a text editor (f. ex. Notepad, Wordpad).

Change the following in the AppManifest.xml:

  1. The <StartPage> section: change every single address so that it points to your site where KanBo is hosted, HTTPS is important. Replace url.placeholder with address of your KanBo IIS.
  2. <RemoteWebApplication> section, change the ClientIdPlaceholder so that it is the same as the ID you’ve previously generated while registering the app in SharePoint.

After the changes have been made, save the file, allow the .zip file to update, and change the file extension back to .app so that it is again.

Uploading the

When you are done with changes in the file you can upload it to the App Catalog. Navigate to your app catalog, choose Apps for SharePoint, upload the file there. (See more here).

In the app catalog, navigate to the "Distribute apps for SharePoint" and upload there our freshly modified file:

Do not install KanBo in AppCatalog! Please do it on the Site Collection.

Adding the KanBo App to your Site Collection

Do not use a system account! Use tenant admin account instead-

Navigate to the site collection, click on add an app:

Find KanBo on the list of the apps you can add and click on it to install it.

You will have to click on "Trust" when asked if you trust the app. After a couple of seconds, you should see the app installed and ready to use. Before navigating to the app please click on the app details to be sure that no errors occurred during the installation process.If no errors occurred you can click on the app to navigate to it.

You might find yourself not able to add this app.

To solve this issue, simply click Find out why link. After you enter the next site, please click Request Approval link.

Simply send it by pressing Request. You don't need to type any text into the white area.

At you might find your pending request for KanBo app approval. Approve it to move forward.

Go to your Site collection -> Settings -> Add an app.

Click on the KanBo app tile.

After clicking Trust it button or solving the App Request problem and then clicking the Trust It button, the KanBo app will be added to your Site Collection. It takes 10-30 seconds depending on the current load of Office 365.

Once the KanBo App has been added, you can proceed with the initial run of KanBo.

First run

Creating the databases

Open https://{YourKanBoAddress}

On the first run of the KanBo app the databases will be created.

You will be directed to the KanBo Setup page. Choose the Automatic Setup option.

Full KanBo installation on Office 365 SharePoint Azure Microsoft

After clicking on the Automatic Setup option, the installation of KanBo Setup will proceed. Wait a couple of seconds until it is finished.

Full KanBo installation on Office 365 SharePoint Azure Microsoft

When the process succeeds you'll be presented with the following communicate (in the screen below in Obtaining the license key part).

Obtaining the license key

You will get the following to communicate. In order to obtain the license key you will need to send us your KanBo.

The selected string is essential for the license key creation process. Please send the KanBo ID to [email protected] so a license key can be generated and send to you.

After obtaining the key you have to paste it into the web.config file. To achieve that, please follow these steps:

Go to KUDU service ( Please navigate to: Debug console -> Powershell -> site ->wwwroot and open the webconfig file.

Enter the web config and paste the license key in the following place.

After updating the pasting the KanBoLicenseKey save the web.config.

Running the app

Open https://{YourKanBoAddress}

You will be directed to the KanBo Setup page. Choose the Automatic Setup option.

Full KanBo installation on Office 365 SharePoint Azure Microsoft

After clicking on the Automatic Setup option, the installation of KanBo Setup will proceed. Wait a couple of seconds until it is finished.

Click on Go back. You will be redirected to your KanBo Landing Page.

Full KanBo installation on Office 365 SharePoint Azure Microsoft

Your KanBo has been successfully installed.

Adding users

After installing KanBo, only the user who has installed it obtains access to the app. In order to allow others to use KanBo they need to be added.

Configure email notifications

Follow to configure email notifications

Configuring KanBo Content Database on Azure

As soon as your KanBo is installed, please delete your temporary SQL database (in this scenario "kanboinstallation_db"). When it is deleted from Azure, we recommend you to purchase a more advanced Pricing Tier for KanBo Content Database.

You can purchase a new pricing plan in the settings of your SQL Database in Azure. Read more about upgrading pricing tiers here.

A change will be necessary for a good performance of KanBo Content Database which has been created during the Setup installation.

You can see dependencies on the table below:

Number of users on your KanBo instance Recommended Pricing Tier for KanBo Content Database
20+ users S0
50+ users S1
100+ users S2

Please keep in mind that you need to change the Pricing Tier only for the KanBo Content database, not for Instances and Profiles databases.

Possible mistakes

  • Be sure that every single address you've provided in the configuration was https and NOT HTTP address.
  • If errors occur please check if the ClientId and ClientSecret are properly provided - many copy-paste errors like spaces in the beginning or the end of these strings
  • If you haven't copied the ClientId direct from browser check if the "-" signs are correctly encoded (the best solution is to delete them and then put back again).

This article was helpful for 3 people. Is this article helpful for you?