This SharePoint Online development tutorial explains how to fix an error occurred in deployment step ‘Install SharePoint Add-in’: The remote server returned an error: (503) Server unavailable, which comes while deploying SharePoint Apps or Add-in to SharePoint Online developer site.
The error “Error occurred in deployment step ‘Install SharePoint Add-in’: The remote server returned an error: (503) Server unavailable” can appear in SharePoint Online, SharePoint 2016/2013. Sometimes professionals also search for “the remote server returned an error 503 server unavailable sharepoint online”.
If you are new to SharePoint Online Apps or Add-in development, then read the below two tutorials on SharePoint Apps:
- SharePoint hosted app development tutorial
- Video Tutorial: Create and Deploy SharePoint Hosted Add-in using Visual Studio
While deploying SharePoint hosted add-in, I got an error like below:
Error occurred in deployment step ‘Install SharePoint Add-in’: The remote server returned an error: (503) Server unavailable.

The remote server returned an error: (503) Server unavailable
To resolve this issue, I have just Clean the visual studio solution and Re-deploy again the SharePoint hosted apps to the SharePoint Online developer site.
Then it started working and the error The remote server returned an error: (503) Server unavailable did not appear.
You may like following SharePoint Apps tutorials:
- Display List items in HTML Table using JSOM in SharePoint Hosted App
- Bind SharePoint Online Host Web List Data to Dropdownlist in SharePoint Hosted Add-in
- Create Site Column, Content type and List in SharePoint Hosted Appa or Add-in
- Error occurred in deployment step ‘Install SharePoint Add-in’: An instance of this App already exists at the specified location.
- you are being redirected to the following URL that was not registered as the app launch URL
- Error occurred in deployment step Install App for SharePoint: Sideloading of apps is not enabled on this site
Hello Everyone!! I am Bhawana a SharePoint MVP and having about 10+ years of SharePoint experience as well as in .Net technologies. I have worked in all the versions of SharePoint from wss to Office 365. I have good exposure in Customization and Migration using Nintex, Metalogix tools. Now exploring more in SharePoint 2016 🙂 Hope here I can contribute and share my knowledge to the fullest. As I believe “There is no wealth like knowledge and no poverty like ignorance”