does anyone knows how to Host SharePoint Framework solution for on-premises deployment ?

i have created a new site for Apps Catalog under my web application in Central Administration, also i have created a webpart using SPFx and generated its .sppkg file and uploaded to the apps catalog but i didn't see my webpart in my on premises solution.

as per video tutorial, i need to upload webpart files and i want NOT to host them on azure but i want to host them on my SharePoint 2016 environment or may be on local sharepoint Farm. how can i do that?

check out the link and go to the section named "Hosting your SharePoint Framework solution for on-premises deployment -> SharePoint 2016" i'm facing issues here

  • Did you find any solution about that ? Jan 2, 2022 at 11:58

1 Answer 1


dont want to sound stupid but have you made sure that your using the correct release version?

Since SharePoint Online and SharePoint 2016 have different release cycles for new capabilities, they also have different capabilities when it comes to the SharePoint Framework. SharePoint Online always uses the latest version of the SharePoint Framework, but SharePoint 2016 only supports the version which matches the server-side dependencies of the deployed packages.+

SharePoint 2016 Feature Pack 2 supports SharePoint Framework client-side web parts hosted in classic SharePoint pages built using the SharePoint Framework v1.1.0. This means that when you are targeting the SharePoint 2016 platform, you'll need to use the SharePoint Framework v1.1.0 due to the server-side version dependencies.

also due to restrictions on 2016 and adding .jsom files

SharePoint 2016 - You can also host your files in the local SharePoint farm itself. You can, for example, define a standardized site in your farm where all the SharePoint Framework assets are being hosted. Take note, however, that by default .json files are not allowed to be uploaded to SharePoint 2016 libraries. So farm level settings will need to be adjusted for this option.

to unrestrict the files (.jsom) then you need to update it in central admin under security -> Define blocked file types.


if all the above is correct then when you add the .sppkg file to the app catalog did you deploy it? once deployed it should be visible in the Apps page section under "apps you can add"

  • Yoman generator 1.3. understand On-Premise and Cloud :) look here --> youtu.be/U61D0DyCIlA?t=34m16s
    – Goshky
    Jan 4, 2018 at 9:02
  • After bundle solution, upload in document library only js files, json files are not required!
    – Goshky
    Jan 4, 2018 at 9:08
  • Thanks for your reply man, i'm aware of SharePoint 2016 Feature Pack 2 and it is already installed, also i've already removed .json file from the blocked list from CA. i have also deployed the solution to apps for sharepoint catalog. my question is where to upload webpart files? Jan 4, 2018 at 9:10
  • In Document library :) best practice is Site collection level --> Style Library
    – Goshky
    Jan 4, 2018 at 9:57
  • when you say "where to upload webpart files" what do you mean? i think you missed a step. good that you have done most of the required steps but now go to "site content" and click on "add an app" -> find your custom app (if deployed) and click on it to add it. once its added under "site content" (might take a little time) it should be visible when you want to add it to a page within "webpart"
    – Ali Jafer
    Jan 4, 2018 at 10:27

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.