CRMJettyBack to crmjetty.comContact us
Menu
Docs / Guides

CRMJetty Portal

Works with
Docs / Dynamics 365

Dynamics 365 Customer Portalv6.3.0

Docs / Salesforce

Salesforce Customer Portalv6.3.0

Docs / Business Central

Business Central Portal

Guides / Hosting and deployment

How to Host CRMJetty Portal on Azure or a Virtual Machine

5 min readUpdated
Short answerOn Azure, create three app services (CJ API, CRM API and CJ Web) and one MS SQL database per portal instance. On your own server, set up IIS, the .NET Hosting Bundle and SQL Server. The CRMJetty team deploys the portal; you then connect your CRM in the admin portal.

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

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

  1. In your Azure subscription, create three app services: one for CJ API, one for CRM API and one for CJ Web.
  2. Create one MS SQL database for the CJ website.
  3. Choose an App Service plan that meets the minimum suggested size. Scale the plan up as your traffic grows.
  4. Give the CRMJetty team temporary access to the Azure details. The team deploys the APIs, the website and the database for you.
  5. For Dynamics 365, install the CRMJetty solution in your CRM. See How to Install the CRMJetty Solution in Dynamics 365.
  6. After deployment, connect your CRM in the admin portal. See Connect your CRM after deployment.

Host the portal on a virtual machine or server

  1. Check that the server meets the minimum requirements. See CRMJetty Portal Server Requirements and Azure Sizing.
  2. Enable IIS and the other Windows features in the table below.
  3. Install SQL Server (Standard or SQL Express) with SQL Authentication enabled.
  4. The CRMJetty team creates deployment folders for CJ API, CRM API and CJ Web and hosts them in IIS.
  5. The team creates one MS SQL database and connects it to the portal website.
  6. Give the IIS user permission on the project folders.
  7. For Dynamics 365, install the CRMJetty solution in your CRM.
  8. 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.

  1. Sign in to the admin portal.
  2. Go to Settings → Portal Settings → CRM Authentication.
  3. Enter the OTP sent to the super admin’s registered email address.
  4. Enter the connection details for your CRM. The fields differ by CRM; follow the CRM-specific article linked below.
  5. 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
Did this solve it?No, contact support