100

What login credentials do I use to connect to the FTP site that is listed on the dashboard of my Azure?

I tried using the same credentials I use to log into Azure, but this failed.

Peter Mortensen
  • 30,738
  • 21
  • 105
  • 131
Klaus Nji
  • 18,107
  • 29
  • 105
  • 185

5 Answers5

131

In the current Azure portal the deployment credentials can be set by going to App Services → select the relevant app service item → in the Deployment section → Deployment Center → FTP → Dashboard. You can either chose to use the preprovided App Credentials or assign User Credentials.

In the previous generation Azure portal the deployment credentials can be set up by going to WEB APPS → select relevant item → DASHBOARD → Reset your deployment credentials.

Make sure you're specifying siteName\userName as your login name. The site name portion is required!

The default directory for the web content is \site\wwwroot which can be set as the initial directory for many FTP clients.

Peter Mortensen
  • 30,738
  • 21
  • 105
  • 131
Simon Opelt
  • 6,136
  • 2
  • 35
  • 66
  • For some reason, when I try to connect to the FTP Host Name using credentials I just setup using link "Setup your deployment credentials", server returns 530: user cannot log in. – Klaus Nji Mar 15 '14 at 22:30
  • 3
    Have you seen [this answer](http://stackoverflow.com/a/11112983/468244)? are you using the full credentials including site and a proper ftp client? – Simon Opelt Mar 15 '14 at 22:53
  • 7
    Just figured the missing element before my actual username i.e site\ftp_user_name. Thanks again. – Klaus Nji Mar 15 '14 at 23:17
  • I have a related issue. No matter how many times I reset the deployment credentials, when I access properties it alwas says there is no ftp/deployment user set. ANd no ftp access is allowed. Winscp says "can not resolve host". Which is even weirder since the same url propmts credential when used in a browser. any thoughts on this? I only need to acces wordpress ocnfig file to set some variables there – Ricker Silva Dec 16 '14 at 16:18
  • What do you mean by "when I access properties it alwas says there is no ftp/deployment user set"? Would it be a good idea to properly document your situation in a new question? – Simon Opelt Dec 16 '14 at 16:26
  • Where is "Reset your deployment credentials"? – thang Feb 12 '16 at 22:35
  • 1
    I had to enter \site\wwwroot as my remote path before I could connect via FTP. – Jamie G Apr 18 '16 at 14:07
  • The entry **Deployment Credentials** has been moved to **App Deployment** in the (as of now) newest version of the portal. It's still part of the ribbon on the left hand side though. – Peter Oct 14 '16 at 12:46
  • @Peter, thanks for the comment. I updated the answer to better reflect the current state of the portal. – Simon Opelt Oct 14 '16 at 20:18
  • @SimonOpelt, could you update your answer to also include the fact that you are required to connect to your root folder (\[sitename]\wwwroot\) for your credentials to work? I read that in one of the comments and it solved the issue for me. Thanks! – Murven Feb 10 '17 at 17:38
  • @Murven, thank you for the input. I should always be `\site\wwwroot` for the default deployment directory independent of the site name. Furthermore most clients should be fine not specifying a directory and just landing in `\` as all accessible directories should be perfectly readable. I could not find any documentation that would explain why directly starting at that directory should be required. – Simon Opelt Feb 10 '17 at 22:31
  • Jan 2019 - New instructions for new UI: Go to App Services / select relevant item / in the DEPLOYMENT section / Deployment Center / Deployment Credentials / App credentials. The ftp username is the displayed username but without the `$` sign. Or go to User credentials to set your own username and password. – MakotoE Jan 27 '19 at 02:56
  • you have to use nameofyoursite NOT nameofyoursite\$nameofyoursite as username – andrej Aug 14 '19 at 15:36
105

If you want use the default value you need to download the publish profile in your dashboard for your site:

Enter image description here

[UPDATE for the new Azure UI]

Enter image description here

It will be an XML file. Open it and find your credentials. Sample:

  <publishProfile
    profileName="nameofyoursite - FTP"
    publishMethod="FTP"
    publishUrl="ftp://waws-prod-blu-001.ftp.azurewebsites.windows.net/site/wwwroot"
    ftpPassiveMode="True"
    userName="nameofyoursite\$nameofyoursite"
    userPWD="sOmeCrYPTicL00kIngStr1nG"
    destinationAppUrl="http://nameofyoursite.azurewebsites.net"
    SQLServerDBConnectionString=""
    mySQLDBConnectionString=""
    hostingProviderForumLink=""
    controlPanelLink="http://windows.azure.com">
    <databases/>
  </publishProfile>

Where your credentials:

publishUrl="ftp://waws-prod-blu-001.ftp.azurewebsites.windows.net/site/wwwroot"

userName="nameofyoursite$nameofyoursite"

userPWD="sOmeCrYPTicL00kIngStr1nG"

Source: Azure Web Sites FTP credentials

Connection from command line on OS X:

Console client:

ftp ftp://nameofyoursite:sOmeCrYPTicL00kIngStr1nG@waws-prod-blu-001.ftp.azurewebsites.windows.net/

Mount from the console:

mkdir /Users/<YOUR_USER>/FTP_AZURE
mount_ftp nameofyoursite:sOmeCrYPTicL00kIngStr1nG@waws-prod-blu-001.ftp.azurewebsites.windows.net/ /Users/<YOUR_USER>/FTP_AZURE
cd /Users/<YOUR_USER>/FTP_AZURE

Open for editing in Vim:

vim ftp://nameofyoursite@waws-prod-blu-001.ftp.azurewebsites.windows.ne//site/wwwroot/

Note the user name here: nameofyoursite, not nameofyoursite$nameofyoursite

Peter Mortensen
  • 30,738
  • 21
  • 105
  • 131
0x8BADF00D
  • 7,138
  • 2
  • 41
  • 34
14

To be complete, you can FTP using two different credentials:

  1. It is already mentioned by @0x8BADF00D. If you downloaded the 'publish profile', you can see the automatically generated credentials for each site.

    In short, if x=your website name, then username=x\$x and the password is a long system generated string

    Enter image description here

    Obviously, this is not meant for a human user...at least I cannot easily remember a 20+ character random string...

  2. There is a more user friendly way. You can set a username and password in Azure portal

    Enter image description here

    However, "deployment user name" is directly tied to a Microsoft account. It is the same for all your web applications. In order to use it to ftp into different web applications, you need to add a prefix.

    Here, my username is "blabla", and my website name is "test" ==> my FTP username is thus "test\blabla" (mind the backslash on Windows) followed by the password I set on Azure portal (no modification required):

    Enter image description here

Here are the references from Azure:

Peter Mortensen
  • 30,738
  • 21
  • 105
  • 131
watashiSHUN
  • 9,684
  • 4
  • 36
  • 44
2

In the Azure portal (end of 2018):

  1. Go to your app
  2. In the left pane, select Deployment Center
  3. In the middle pane, select FTP
  4. Click view dashboard, and there you have your ftps connection url, username and password.

You must enable FTP/S on your web app to actually be able to connect! This is done under Application Settings -> FTP Access in the Azure portal

Jim Aho
  • 9,932
  • 15
  • 56
  • 87
2

These two blades give all the required information to connect via FTP.

App Service > Settings > Properties

enter image description here

App Service > Deployment > Deployment Center > Deployment Credentials

enter image description here

Shaun Luttin
  • 133,272
  • 81
  • 405
  • 467
  • What is the meaning of ["blades"](https://en.wiktionary.org/wiki/blade#Noun) in this context? None of the 23 listed items seem to fit. Presumably not as in [blade server](https://en.wikipedia.org/wiki/Blade_server) – Peter Mortensen Jul 25 '21 at 09:45