> ## Documentation Index
> Fetch the complete documentation index at: https://syteca.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Deploy Syteca on Azure Cloud from Azure Marketplace

> Deploy Syteca on Azure Cloud using the Azure Marketplace listing. An end-to-end automated deployment that provisions Application Server, SQL database, and network configuration in a single wizard.

## Skip the manual VM buildout by deploying Syteca directly from Azure Marketplace

Manual cloud deployments of Syteca work, but they require sequenced work across virtual machine provisioning, SQL server installation, Syteca MSI installation, network configuration, and public endpoint exposure. Each step needs its own decisions, and mistakes cascade forward. A missing port opening in the initial network configuration means an inaccessible Management Tool later. An undersized VM chosen in step one means a migration to a larger VM later.

The Azure Marketplace listing packages all of those decisions into a single wizard. The wizard provisions the resource group, database, virtual machines, and network configuration in one deployment, then hands back a ready-to-use Application Server URL. The choices you make in the wizard determine the shape of the final deployment. Everything else is automated.

<Info>
  **Use the Azure Marketplace deployment when your organization needs any of the following:**

  1. A fast path from purchase decision to working Syteca deployment, without a manual cloud engineering effort.
  2. A cloud-first Syteca deployment where no on-premises Application Server is planned.
  3. Standardization across a portfolio of Azure-hosted internal tools.
  4. A choice between MS SQL, PostgreSQL, or Azure SQL Database as the backing database, made in the wizard rather than through a separate DBA procedure.
</Info>

<Warning>
  **NOT AVAILABLE IN SAAS.** The Azure Marketplace listing is one way to install a self-managed Syteca deployment on Azure. It is not the Syteca SaaS offering, which runs on Syteca-managed infrastructure.
</Warning>

## Prerequisites

Before starting the deployment, gather the following:

1. **An Azure subscription** with capacity available in the region where you want to deploy.

2. **A Microsoft user account** with permissions to create new resources using that subscription.

To reuse an existing SQL Server instead of provisioning a new one during deployment:

3. **The existing SQL Server must be accessible over the Internet** from the Azure region where Syteca will be deployed.

4. **Connection details for the SQL Server**, including the fully qualified server name.

5. **Credentials of a SQL Server user with system administrator permissions.** The deployment wizard needs these to create the Syteca database schema on the existing server.

To review database sizing and version requirements, see [System Requirements](/docs/get-started/system-requirements).

## The deployment process

The full deployment runs from the Azure Portal. Estimated time from starting the wizard to a working Application Server is **30 to 50 minutes**, depending on the database type chosen and the region.

The wizard has five configuration tabs, followed by a review step and the deployment wait. Each tab is covered in its own sub-section below.

### Start the Azure Marketplace wizard

<Steps>
  <Step title="Log in to the Azure Portal">
    Open [https://portal.azure.com/](https://portal.azure.com/) and log in with the Microsoft account you plan to use for the deployment.
  </Step>

  <Step title="Create a resource">
    On the Azure Portal **Home** page, click **Create a resource**.
  </Step>

  <Step title="Find Syteca in the Marketplace">
    In the **Search the Marketplace** field, enter **Syteca**.
  </Step>

  <Step title="Open the installation wizard">
    Click **Create** on the listing to open the installation wizard.
  </Step>
</Steps>

<Frame caption="Azure Marketplace search for the Syteca listing. Click Create to open the installation wizard.">
  <img src="https://mintcdn.com/syteca/0FlD-vkHsBA1azVX/images/administration/deployment/azure-marketplace-search.png?fit=max&auto=format&n=0FlD-vkHsBA1azVX&q=85&s=ff6e23302073d41c7ed8172bfd9eb7d0" alt="Azure Marketplace search result showing the Syteca listing" width="1864" height="607" data-path="images/administration/deployment/azure-marketplace-search.png" />
</Frame>

### Configure the Basics tab

On the **Basics** tab, select the Azure subscription to use, create a new resource group, and select the region where Syteca will be deployed. Click **Next** when the fields are set.

<Warning>
  **Existing resource groups cannot be used** to deploy Syteca. Click **Create new** under the **Resource group** field. In the pop-up window, enter a name unique to your subscription.
</Warning>

<Frame caption="Basics tab. Subscription, a new resource group, and target region.">
  <img src="https://mintcdn.com/syteca/0FlD-vkHsBA1azVX/images/administration/deployment/azure-basics-tab.png?fit=max&auto=format&n=0FlD-vkHsBA1azVX&q=85&s=bb3817a935d07a56071386b2880459c6" alt="Syteca Azure installation wizard Basics tab" width="973" height="344" data-path="images/administration/deployment/azure-basics-tab.png" />
</Frame>

### Configure the Database Storage Configuration tab

On the **Database Storage Configuration** tab, choose whether to install a new SQL server or reuse an existing one.

**Reuse an existing SQL Server.** Provide the fully qualified server name (for example, `myserver.example.com`) and the credentials for a SQL user with sysadmin permissions.

**Install a new SQL Server.** Choose the SQL type: MS SQL, PostgreSQL, or Azure SQL Database.

| SQL type               | What gets provisioned                                                                                                                               |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **MS SQL**             | A new virtual machine in the resource group hosting a Microsoft SQL Server instance. You select the data disk size, log disk size, and custom port. |
| **PostgreSQL**         | A new virtual machine hosting a PostgreSQL instance. You select the data disk type, data disk size, and custom port.                                |
| **Azure SQL Database** | A managed Azure SQL Database. You provide a globally unique server name that will form the fully qualified `<name>.database.windows.net` domain.    |

Select the virtual machine size for the SQL VM based on the number of Clients you plan to monitor concurrently. For sizing, see [System Requirements](/docs/get-started/system-requirements). To change the size after the initial selection, use the **Change size** button in the wizard.

<Note>
  For PostgreSQL, only the default user name `postgres` is currently supported. If your organization requires a different administrative user, this constraint may block the PostgreSQL option.
</Note>

Click **Next** once the database configuration is complete.

### Configure the Application Server Configuration tab

On the **Application Server Configuration** tab, choose whether to install the Application Server on a standalone virtual machine (recommended) or on the same virtual machine as the SQL server.

**Standalone Application Server VM (recommended).** Define VM size, public IP configuration, and domain name label. The domain name label combines with a region-specific suffix (for example, `.eastus.cloudapp.azure.com`) to form a globally unique fully qualified domain name.

**Co-located Application Server on the SQL VM.** Available only if a new MS SQL or PostgreSQL server was chosen in the previous step. Configure public access parameters for the shared VM.

<Warning>
  **Do not select None for the Public IP address** if you plan to access the virtual machine over the Internet. Reachability over the Internet is required to monitor on-premises Syteca Clients or to access the Management Tool from an on-premises environment.
</Warning>

Define the Management Tool default user credentials and URL. The default user name is `admin`. These credentials will be used to log in to the Management Tool.

<Warning>
  **Record these credentials before continuing.** Losing them requires a Syteca support intervention to recover Management Tool access.
</Warning>

Click **Next** once the Application Server configuration is complete.

### Configure the Network Configuration tab

On the **Network Configuration** tab, adjust the virtual network settings for the deployment, or accept the defaults.

Two optional ports control external reachability:

| Port     | Purpose                                                                                                                                           |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **9447** | Allow connections from on-premises Syteca Clients to the Application Server. Open this port when you plan to monitor endpoints outside Azure.     |
| **443**  | Allow HTTPS access to the Management Tool from outside Azure. Open this port when the Management Tool will be accessed from browsers on-premises. |

<Note>
  These port options are only available if the Public IP address in the previous step was not set to **None**.
</Note>

For monitoring Syteca Clients that live in other resource groups or Azure regions, choose between exposing the Application Server on the Internet or configuring a VNet-to-VNet VPN gateway. For the VPN gateway configuration, see the [Microsoft VNet-to-VNet VPN gateway documentation](https://docs.microsoft.com/en-us/azure/vpn-gateway/vpn-gateway-howto-vnet-vnet-resource-manager-portal).

Click **Next**.

### Review, launch, and wait

On the **Review + create** tab, review every setting. Read the Terms of Use carefully. Click **Create** to start deployment.

Deployment takes between 30 and 50 minutes depending on the settings chosen. Progress is visible on the Azure Portal **Resource group** page, on the **Deployments** tab, and on the **Overview** tab of the specific deployment.

<Frame caption="Azure deployment progress across the resources being provisioned for Syteca.">
  <img src="https://mintcdn.com/syteca/0FlD-vkHsBA1azVX/images/administration/deployment/azure-deployment-progress.png?fit=max&auto=format&n=0FlD-vkHsBA1azVX&q=85&s=24f860671c942196bc4552c460e9d440" alt="Azure deployment progress view showing Syteca resources being created" width="1152" height="648" data-path="images/administration/deployment/azure-deployment-progress.png" />
</Frame>

When the deployment finishes, the **Resource group** page **Overview** tab shows the full list of resources created. These include the Application Server VM, the SQL VM (if a new SQL server was provisioned), virtual network resources, and network security groups.

## Access the Management Tool for the first time

Once the deployment completes, the Application Server is running but not yet in use. To reach the Management Tool:

1. In the resource group's list of deployed resources, click the virtual machine named `EkranServer` (the default name for the Application Server VM).

2. On the VM's **Overview** tab, in the **Essentials** section, copy the **DNS name** of the virtual machine.

3. Combine the DNS name with the URL configured during deployment (the default is `ekransystem`) to form the Management Tool URL. For example, if the DNS name is `syteca.eastus.cloudapp.azure.com` and the configured URL is `ekransystem`, the full Management Tool URL is:

   ```text theme={"system"}
   https://syteca.eastus.cloudapp.azure.com/ekransystem/
   ```

4. Open a browser and paste the full URL into the address bar.

5. Log in with the default user name (`admin`) and the password chosen during deployment.

<Note>
  If port 443 was opened during deployment, the Management Tool is reachable from any browser with Internet access. If not, the Management Tool is only reachable from a browser running on the Application Server virtual machine itself. To open port 443 later, adjust the Network Security Group associated with the Application Server VM.
</Note>

## Related

<CardGroup cols={2}>
  <Card title="System requirements" icon="server" href="/docs/get-started/system-requirements">
    Sizing, database, and network requirements to inform the wizard choices.
  </Card>

  <Card title="Install the Application Server (on-premises)" icon="server-cog" href="/docs/administration/deployment/install-application-server">
    Manual on-premises installation, for comparison with the Marketplace path.
  </Card>

  <Card title="Deployment architecture" icon="network" href="/docs/administration/deployment/architecture">
    How Application Server, database, and Clients fit together after deployment.
  </Card>

  <Card title="Update Syteca" icon="download" href="/docs/administration/deployment/update-syteca">
    Ongoing update procedures after the initial Marketplace deployment.
  </Card>
</CardGroup>
