setup-ipsec-vpn/azure/README.md

# Deploy to Microsoft Azure

*Read this in other languages: [English](README.md), [简体中文](README-zh.md).*

This template will create a fully working VPN server on the Microsoft Azure Cloud ([pricing details](https://azure.microsoft.com/en-us/pricing/details/virtual-machines/)).

Customizable with the following options:

 - Username for VPN **and** SSH
 - Password for VPN **and** SSH
 - IPsec Pre-Shared Key for VPN
 - Operating System Image (Ubuntu 20.04/18.04 or Debian 9)
 - Virtual Machine Size (Default: Standard_B1s)

**Note:** DO NOT use these special characters within values: `\ " '`

Press this button to start:

[![Deploy to Azure](../docs/images/azure-deploy-button.png)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fhwdsl2%2Fsetup-ipsec-vpn%2Fmaster%2Fazure%2Fazuredeploy.json)

When the deployment finishes, Azure displays a notification. Next steps: [Configure VPN Clients](../README.md#next-steps).

**Note:** When connecting to the server using SSH, use the username and password you specified in the deployment template. To add or export IKEv2 clients, run `sudo ikev2.sh`. If somehow you still cannot SSH into the VM after entering the correct login credentials, see [Troubleshoot SSH connections to an Azure Linux VM that fails, errors out, or is refused](https://docs.microsoft.com/en-us/troubleshoot/azure/virtual-machines/troubleshoot-ssh-connection) and/or [Can't SSH to Azure Linux VM because permissions are too open](https://docs.microsoft.com/en-us/troubleshoot/azure/virtual-machines/troubleshoot-ssh-permissions-too-open).

## Authors

Copyright (C) 2016 [Daniel Falkner](https://github.com/derdanu)   
Copyright (C) 2017-2022 [Lin Song](https://github.com/hwdsl2)

## Screenshot

![Azure Custom Deployment](custom_deployment_screenshot.png)
Update docs 2017-03-20 06:10:49 +03:00			`# Deploy to Microsoft Azure`
Update README.md [ci skip] 2016-08-11 06:15:11 +03:00
Update docs 2022-01-23 00:34:38 +03:00			`Read this in other languages: [English](README.md), [简体中文](README-zh.md).`
Update README.md [ci skip] 2016-08-11 06:15:11 +03:00
Update docs 2021-06-05 01:27:21 +03:00			`This template will create a fully working VPN server on the Microsoft Azure Cloud ([pricing details](https://azure.microsoft.com/en-us/pricing/details/virtual-machines/)).`
Update README.md [ci skip] 2016-08-11 06:15:11 +03:00
			`Customizable with the following options:`

Update docs 2020-05-04 06:12:17 +03:00			`- Username for VPN and SSH`
			`- Password for VPN and SSH`
Fix Azure template - Switch to version 2 of the Azure Custom Script Extension - Use default VM size "Basic_A0" for deployments (configurable) - Clean up install.sh, and other minor improvements 2017-05-31 22:13:54 +03:00			`- IPsec Pre-Shared Key for VPN`
Update docs - Remove Ubuntu 16.04, whose standard support will end on April 30, 2021 - Add a note on CentOS Linux 8 2021-04-26 08:06:17 +03:00			`- Operating System Image (Ubuntu 20.04/18.04 or Debian 9)`
Update Azure template - Use Debian 9 instead of Debian 8 - Update Virtual Machine size options - Add wait for apt/dpkg lock in install.sh 2018-05-10 10:57:08 +03:00			`- Virtual Machine Size (Default: Standard_B1s)`
Update README.md [ci skip] 2016-08-11 06:15:11 +03:00
Fix Azure deploy - Fix handling of special characters in the Azure deployment config by quoting the VPN parameters - Fixes #644. Thanks @turbozapekanka for the report! 2019-11-02 07:34:56 +03:00			Note: DO NOT use these special characters within values: `\ " '`

Update README.md [ci skip] 2016-08-11 06:15:11 +03:00			`Press this button to start:`

Update docs 2021-06-05 01:27:21 +03:00			`[![Deploy to Azure](../docs/images/azure-deploy-button.png)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fhwdsl2%2Fsetup-ipsec-vpn%2Fmaster%2Fazure%2Fazuredeploy.json)`
Update docs 2017-06-12 10:29:53 +03:00
Update Azure config - Add Ubuntu 20.04 to OS options, and set as default 2020-08-29 08:01:05 +03:00			`When the deployment finishes, Azure displays a notification. Next steps: [Configure VPN Clients](../README.md#next-steps).`
Update README.md [ci skip] 2016-08-11 06:15:11 +03:00
Update docs - Ref: #1145 2022-04-06 07:06:01 +03:00			Note: When connecting to the server using SSH, use the username and password you specified in the deployment template. To add or export IKEv2 clients, run `sudo ikev2.sh`. If somehow you still cannot SSH into the VM after entering the correct login credentials, see [Troubleshoot SSH connections to an Azure Linux VM that fails, errors out, or is refused](https://docs.microsoft.com/en-us/troubleshoot/azure/virtual-machines/troubleshoot-ssh-connection) and/or [Can't SSH to Azure Linux VM because permissions are too open](https://docs.microsoft.com/en-us/troubleshoot/azure/virtual-machines/troubleshoot-ssh-permissions-too-open).
Update docs 2022-02-27 03:12:47 +03:00
Fix Azure template - Switch to version 2 of the Azure Custom Script Extension - Use default VM size "Basic_A0" for deployments (configurable) - Clean up install.sh, and other minor improvements 2017-05-31 22:13:54 +03:00			`## Authors`
Update README.md [ci skip] 2016-08-11 06:15:11 +03:00
Update docs 2017-06-12 10:29:53 +03:00			`Copyright (C) 2016 [Daniel Falkner](https://github.com/derdanu)`
Update year 2022-01-02 09:09:03 +03:00			`Copyright (C) 2017-2022 [Lin Song](https://github.com/hwdsl2)`
Update docs [ci skip] 2016-12-22 19:27:56 +03:00
			`## Screenshot`

			`![Azure Custom Deployment](custom_deployment_screenshot.png)`