Introduction to Azure Web App on Linux

Note

Azure Web App on Linux is currently in public preview and supports running web apps natively on Linux.

Overview

Customers can use Web App on Linux to host web apps natively on Linux for supported application stacks. The following section lists the application stacks that are currently supported.

Features

Web App on Linux currently supports the following application stacks:

  • Node.js
    • 4.4
    • 4.5
    • 6.2
    • 6.6
    • 6.9
    • 6.10
  • PHP
    • 5.6
    • 7.0
  • .Net Core
    • 1.0
    • 1.1
  • Ruby
    • 2.3

Customers can deploy their applications by using:

  • FTP
  • Local Git
  • GitHub
  • Bitbucket

For application scaling:

  • Customers can scale web apps up and down by changing the tier of their App Service plan
  • Customers can scale out applications and run multiple app instances within the confines of their SKU

For Kudu, some of the basic functionality:

  • Environments
  • Deployments
  • Basic console
  • SSH

For devops:

  • Staging environments
  • ACR and DockerHub CI/CD

Limitations

The Azure portal shows only features that currently work for Web App on Linux and hides the rest. As we enable more features, they will be visible on the portal.

Some features, such as virtual network integration, Azure Active Directory/third-party authentication, or Kudu site extensions, are not available yet. Once these features are available, we will update our documentation and blog about the changes.

This public preview is currently only available in the following regions:

  • West US
  • East US
  • West Europe
  • North Europe
  • South Central US
  • North Central US
  • Southeast Asia
  • East Asia
  • Australia East
  • Japan East
  • Brazil South
  • South India

Web Apps on Linux is only supported in the Dedicated app service plans and does not have a Free or Shared tier. Also, App Service plans for regular and Linux web apps are mutually exclusive, so you cannot create a Linux web app in a non-Linux app service plan.

Web Apps on Linux must be created in a resource group that does not contain non-Linux web apps in the same region.

Troubleshooting

When your application fails to start or you want to check the logging from your app, check the Docker logs in the LogFiles directory. You can access this directory either through your SCM site or via FTP. To log the stdout and stderr from your container, you need to enable Docker Container logging under Diagnostics Logs.

Enabling Logging

Using Kudu to view Docker logs

You can access the SCM site from Advanced Tools in the Development Tools menu.

Next steps

See the following links to get started with App Service on Linux. You can post questions and concerns on our forum.