# Step 1a - Configuring the Virtual Machine Scale Set manually

Product: Marketplace Offerings
Source: https://docs.fortytwo.io/marketplace-offerings/self-hosted-runners/github/step1-manual/

:::note
If you do not want to handle the creation of the VMSS manually, you can use our [other methods](https://docs.fortytwo.io/marketplace-offerings/self-hosted-runners/github/#select-your-deployment-option) instead.
:::

## Create the Virtual Machine Scale Set

Start by going to the Azure Portal and click **+Create a resource**.

![The +Create a resource button in the Azure Portal](https://docs.fortytwo.io/marketplace-offerings/self-hosted-runners/github/media/20230914091454.png)

Search for **Virtual Machine Scale Set**, click on the result and click **Create**

![Virtual Machine Scale Set in the search results](https://docs.fortytwo.io/marketplace-offerings/self-hosted-runners/github/media/20230914091624.png)

::::steps
### Basics

- **Project details**
    - **Subscription** - A subscription you have contributor access to
        - **Resource group** - A new or existing resource group
- **Scale set details**
    - **Virtual machine scale set name** - The name of the scale set itself. Cannot be changed after deployment, but everything is stateless, so you can simply deploy a new scale set if needed.
    - **Region** - The region where you want your runners to be located
    - **Availability zone** - Configure to None in order to allow for a cluster with few running instances
- **Orchestration**
    - **Orchestration mode** - Configure to **Uniform**, as we will be running only a single image and runner type
    - **Security type** - Standard is the only supported for our image currently
- **Instance details**
    - **Image** - Locate the Fortytwo **Self Hosted Runner for Azure GitHub** image and select whether you want an Ubuntu or Windows based runner:

        ![Selecting the Fortytwo Self Hosted Runner image](https://docs.fortytwo.io/marketplace-offerings/self-hosted-runners/github/media/20230914092637.png)

    - **Run with Azure Spot discount** - Only select this if you know how to handle spot, and if your pipelines can tolerate evictions
    - **Size** - Choose the virtual machine size you want to run the runners as
- **Administrator account**
    - Configure an administrator account for you virtual machines

![The Basics page of the scale set wizard](https://docs.fortytwo.io/marketplace-offerings/self-hosted-runners/github/media/20230914091817.png)

![More of the Basics page of the scale set wizard](https://docs.fortytwo.io/marketplace-offerings/self-hosted-runners/github/media/20230914092429.png)

### Spot

Skip configuring **Spot** unless you chose to **Run with Azure spot discount**.

### Disks

Leave **Disks** as default and go to the next page.

### Networking

On the **Networking** page, you can choose between creating a new network or reuse an existing one. You can easily connect to a virtual network that is peered into a Azure Landing Zones solution and use private endpoints and stuff.

:::warning
Please be aware that the runners require internet connectivity in order to reach GitHub.
:::

- **Load balancing options** - Choose **None**, as GitHub takes care of this

The default settings will work just fine in most cases:

![The Networking page with default settings](https://docs.fortytwo.io/marketplace-offerings/self-hosted-runners/github/media/20230914093403.png)

### Scaling

For scaling, you should configure **Initial instance count** to **0**, as we need to configure the VMSS for Github connectivity before creating our first instances.

![The Scaling page with Initial instance count set to 0](https://docs.fortytwo.io/marketplace-offerings/self-hosted-runners/github/media/20230914093755.png)

### Management, Health, Advanced and Tags

No need to configure any of this. Just click next and complete the deployment of VMSS.

![Completing the deployment of the VMSS](https://docs.fortytwo.io/marketplace-offerings/self-hosted-runners/github/media/20230914093939.png)

### Final configuration

After successfully creating the VMSS instance, click **Go to resource**

![The Go to resource button](https://docs.fortytwo.io/marketplace-offerings/self-hosted-runners/github/media/20230914094919.png)

Under **Upgrade policy**, switch from manual to **Automatic**.

![Upgrade policy set to Automatic](https://docs.fortytwo.io/marketplace-offerings/self-hosted-runners/github/media/20230914095007.png)
::::

[Continue to step 2 - Configuring the virtual machine scale set for auto registration](https://docs.fortytwo.io/marketplace-offerings/self-hosted-runners/github/step2/)
