How to Host CRMJetty Portal on Azure or a Virtual Machine
You can run CRMJetty Portal in your own Azure subscription or on a virtual machine or server you manage, instead of in the CRMJetty cloud. Choose this when your organization needs to decide where the portal and its database are hosted.
Note: This feature is available on selected plans. See Pricing.
Before you start
- Decide between Azure and your own server. See Cloud vs On-Premise vs Azure Deployment for CRMJetty.
- Check the minimum sizing in CRMJetty Portal Server Requirements and Azure Sizing.
- Have an SSL certificate and a domain for the portal.
- Have the connection details for your CRM ready. See CRM Connection Requirements for CRMJetty Portal.
What a portal instance needs
Each portal instance is made of three applications and one database. For how they fit together, see Self-Hosted CRMJetty Portal Architecture Explained.
| Component | On Azure | On a virtual machine or server |
|---|---|---|
| CJ API | Azure App Service | Site in IIS |
| CRM API | Azure App Service | Site in IIS |
| CJ Web (the portal website) | Azure App Service | Site in IIS |
| Portal database | Azure SQL (MS SQL) database | MS SQL Server database (Standard or SQL Express) |
If you run a sandbox and a live instance, you need two full sets: six app services and two databases.
Host the portal in Azure
- In your Azure subscription, create three app services: one for CJ API, one for CRM API and one for CJ Web.
- Create one MS SQL database for the CJ website.
- Choose an App Service plan that meets the minimum suggested size. Scale the plan up as your traffic grows.
- Give the CRMJetty team temporary access to the Azure details. The team deploys the APIs, the website and the database for you.
- For Dynamics 365, install the CRMJetty solution in your CRM. See How to Install the CRMJetty Solution in Dynamics 365.
- After deployment, connect your CRM in the admin portal. See Connect your CRM after deployment.
Host the portal on a virtual machine or server
- Check that the server meets the minimum requirements. See CRMJetty Portal Server Requirements and Azure Sizing.
- Enable IIS and the other Windows features in the table below.
- Install SQL Server (Standard or SQL Express) with SQL Authentication enabled.
- The CRMJetty team creates deployment folders for CJ API, CRM API and CJ Web and hosts them in IIS.
- The team creates one MS SQL database and connects it to the portal website.
- Give the IIS user permission on the project folders.
- For Dynamics 365, install the CRMJetty solution in your CRM.
- Connect your CRM in the admin portal.
| Server prerequisite | Details |
|---|---|
| IIS | Internet Information Services, with its related features. |
| IIS Hostable Web Core | Windows feature. |
| .NET Framework Advanced Services | Windows feature (listed in the old docs as .NET Framework 4.3 Advanced Service). |
| .NET Hosting Bundle | The version CRMJetty specifies for your portal build. Older guides list 6.0.22. |
| SQL Server | Database with SQL Authentication. |
| Folder permissions | The IIS user needs permission on the project folders. |
For the IIS steps, see How to Set Up IIS for a Self-Hosted CRMJetty Portal.
Connect your CRM after deployment
The portal does not work until you connect it to your CRM.
- Sign in to the admin portal.
- Go to Settings → Portal Settings → CRM Authentication.
- Enter the OTP sent to the super admin’s registered email address.
- Enter the connection details for your CRM. The fields differ by CRM; follow the CRM-specific article linked below.
- Select Save, then Test Connection.
For Business Central, the page is Settings → Portal Settings → Business Central Authentication.
For each CRM, see How to Connect Dynamics 365 to CRMJetty Portal, Getting Started with Salesforce Customer Portal Setup or How to Connect Business Central to CRMJetty Portal.
Plan for maintenance
A self-hosted portal needs regular maintenance. CRMJetty’s hosting guide estimates about 8 hours a month on Azure and about 12 hours a month on your own server.
| Task | Azure | Virtual machine or server |
|---|---|---|
| Check backup status for the app and database | Yes | Yes |
| Check domain expiration | Yes | Yes |
| Check the SSL certificate | Yes | Yes |
| HTTP monitoring | Yes | Yes |
| Review the event log | Yes | Yes |
| Review firewall settings | Yes | Yes |
| Check system security and apply patches | Yes | |
| Update the server operating system | Yes | |
| Review for signs of hardware errors | Yes | |
| Scan for malware | Yes | |
| Check disk space | Yes | |
| Clean up logs | Yes | |
| Change passwords | Yes |
Related articles
- Self-Hosted CRMJetty Portal Architecture Explained
- How to Set Up IIS for a Self-Hosted CRMJetty Portal
- CRMJetty Portal Server Requirements and Azure Sizing