Test app behavior in different environment
Upload your app to Teams
You can sideload your Teams app to Microsoft Teams without having to publish to your organization or the Microsoft Teams Store in the following scenarios:
- You want to test and debug an app locally or on your testing cloud environment.
- You built an app for yourself to automate a workflow.
- You built an app for a small set of users, such as, your work group.
- Sideloading of apps is possible only in Government Community Cloud (GCC) and isn't possible in GCC-High and Department of Defense (DOD).
- App installation is supported only on Teams desktop client.
- Ensure to create your app package and validate it for errors.
- Enable custom app uploading in Teams.
- Ensure that your app is running and accessible using HTTPs.
Upload your app
You can sideload your app to a team, chat, meeting, or for personal use depending on how you configured your app's scope.
Log in to the Teams client with your Microsoft 365 development account.
Select Apps > Manage your apps and Upload an app.
Select Upload a custom app.
Select your app package .zip file.
Add your app to Teams as per your requirement:
- Select Add to add your personal app.
- Use the dropdown menu to add your app to a Team or chat.
You can test your Teams app after integrating with Microsoft Teams. To test your Teams app, you need to create at least one workspace in your environment. You can use Teams Toolkit for testing your Teams app:
Locally hosted in Teams: Teams Toolkit locally hosts your Teams app by sideloading it into Teams for testing in local environment.
Cloud-hosted in Teams: For testing your Teams app remotely, you need to Cloud-host it using provisioning and deploying on Microsoft Azure Active Directory (Azure AD). It involves uploading your solution to the Azure AD and then upload into Teams.
For production-scale debugging and testing, we recommend that you follow your own company guidelines to ensure you are able to support testing, staging, and deployment through your own processes.
Locally hosted environment
Teams is a cloud-based product that requires all services it accesses, to be available publicly using HTTPS endpoints. Local hosting is about sideloading into Teams for testing in local environment.
To host your development and production code and their HTTPS endpoints, you need to remotely test your teams app using provisioning and deploying on Azure AD. You need to ensure that all domains are accessible from your Teams app listed in the
validDomains object in the
To ensure a secure environment, be explicit about the exact domain and subdomains you reference and those domains must be in your control. For example,
*.azurewebsites.net is not recommended, however
contoso.azurewebsites.net is recommended.