🥇 Sitecore MVP Program Site

This is the new Sitecore MVP site - build against Sitecore 10.1 utillising the new .NET Core development experience.

🚧🚧🚧 This is a work in progress and as such will probably contain some errors, bugs etc that will hopefully be fixed before go live 🚧🚧🚧

💗 Contributions

The Sitecore MVP site is an Open Source project and as such we welcome community contributions, though Sitecore has a "No commitment" approach to this repository. Please read the Code of Conduct and Contribution Guide before participating

✋ PreRequisites

• .NET Core (>= v 3.1) and .NET Framework 4.8
• MKCert
• Approx 40gb HD space
• Okta Developer Account

💻 Initial Setup

1. If your local IIS is listening on port 443, you'll need to stop it for now.

   iisreset /stop
   

2. Before you can run the solution, you will need to prepare the following for the Sitecore container environment:

   • A valid/trusted wildcard certificate for *.sc.localhost

   • Hosts file entries for

     • mvp-cd.sc.localhost
     • mvp-cm.sc.localhost
     • mvp-id.sc.localhost
     • mvp.sc.localhost

   • Required environment variable values in .env for the Sitecore instance

     • (Can be done once, then checked into source control.)

   See Sitecore Containers documentation for more information on these preparation steps. The provided init.ps1 will take care of them, but you should review its contents before running.

   You must use an elevated/Administrator Windows PowerShell 5.1 prompt for this command, PowerShell 7 is not supported at this time.

   .\init.ps1 -InitEnv -LicenseXmlPath "C:\path\to\license.xml" -AdminPassword "DesiredAdminPassword"

3. At the bottom of the .env file you'll find the section for your Okta developer account details. You will need to populate the following values:

   • OKTA_DOMAIN
   • OKTA_CLIENT_ID
   • OKTA_CLIENT_SECRET

4. After completing this environment preparation, run the startup script from the solution root: ps1 .\up.ps1

5. When prompted, log into Sitecore via your browser, and accept the device authorization.

6. Wait for the startup script to open browser tabs for the rendered site and Sitecore Launchpad.

⚠️ Troubleshooting

If have issues running the site locally, please refer to the Troubleshooting page on the wiki before opening an issue.