Knowledge base / Intranet Builder / Installation
Deployment
A typical first installation: verify the bundle, register the installer app, bootstrap the administration site, approve API access, design the home site, run the three installer commands, then repeat per site. Full guide: docs/INSTALLATION.md.
- Extract and check the bundle
Match
Get-FileHash ./intranet-builder-<release>.zip -Algorithm SHA256against the published hash, extract, thenGet-ChildItem -Recurse | Unblock-File. Run every command from the extracted folder. - Register the installer application
Once per tenant (Entra administrator):
Register-PnPEntraIDAppForInteractiveLogin -ApplicationName 'Intranet Builder Installer' -Tenant contoso.onmicrosoft.com. Consent, and note the client ID (not a secret). - Prepare the administration site
As SharePoint Administrator:
./Install-Intranet.ps1 -Bootstrap -AdminSiteUrl https://contoso.sharepoint.com/sites/intranet-admin -HomeSiteUrl https://contoso.sharepoint.com/sites/intranet -PackagePath ./packages -ClientId <id>. Add the intranet team as owners. - Approve API access
SharePoint admin center › Advanced › API access: approve the Graph requests of the packages you use (see Part 2).
- Design the home site in Setup Center
Prerequisites › target › Corporate home template › modules › branding › data sources › permissions › change preview › provisioning (download JSON) › launch checklist.
- Run the installer
./Test-Prerequisites.ps1 -ConfigurationPath ./intranet-xxxx.json -ClientId <id>, then./Get-DeploymentPlan.ps1 …(resolve conflicts), then./Install-Intranet.ps1 …. Progress appears in Setup Center. - Check and launch
Health Dashboard or
Test-Intranet.ps1; apply the printed repairs; complete the launch checklist; author content. Repeat for department, HR and knowledge sites.
Upgrades and removal
- Upgrade: extract the new bundle, run
-Bootstrapfrom it, preview a pilot site withUpdate-Intranet.ps1 -WhatIf, update the pilot, test it, then update the home site and the rest. Additive: missing columns, views and settings are added; edited pages are left alone. - Remove from a site: disable its modules (content is kept; delete lists and pages yourself after exporting). To remove the components from the tenant, retract the packages in the app catalog.