Deep-dive on the Next Gen Platform. Join the Webinar!

Skip Navigation
Show nav
Dev Center
  • Get Started
  • Documentation
  • Changelog
  • Search
  • Get Started
    • Node.js
    • Ruby on Rails
    • Ruby
    • Python
    • Java
    • PHP
    • Go
    • Scala
    • Clojure
    • .NET
  • Documentation
  • Changelog
  • More
    Additional Resources
    • Home
    • Elements
    • Products
    • Pricing
    • Careers
    • Help
    • Status
    • Events
    • Podcasts
    • Compliance Center
    Heroku Blog

    Heroku Blog

    Find out what's new with Heroku on our blog.

    Visit Blog
  • Log inorSign up
Hide categories

Categories

  • Heroku Architecture
    • Compute (Dynos)
      • Dyno Management
      • Dyno Concepts
      • Dyno Behavior
      • Dyno Reference
      • Dyno Troubleshooting
    • Stacks (operating system images)
    • Networking & DNS
    • Platform Policies
    • Platform Principles
  • Developer Tools
    • Command Line
    • Heroku VS Code Extension
  • Deployment
    • Deploying with Git
    • Deploying with Docker
    • Deployment Integrations
  • Continuous Delivery & Integration (Heroku Flow)
    • Continuous Integration
  • Language Support
    • Node.js
      • Working with Node.js
      • Node.js Behavior in Heroku
      • Troubleshooting Node.js Apps
    • Ruby
      • Rails Support
      • Working with Bundler
      • Working with Ruby
      • Ruby Behavior in Heroku
      • Troubleshooting Ruby Apps
    • Python
      • Working with Python
      • Background Jobs in Python
      • Python Behavior in Heroku
      • Working with Django
    • Java
      • Java Behavior in Heroku
      • Working with Java
      • Working with Maven
      • Working with Spring Boot
      • Troubleshooting Java Apps
    • PHP
      • PHP Behavior in Heroku
      • Working with PHP
    • Go
      • Go Dependency Management
    • Scala
    • Clojure
    • .NET
      • Working with .NET
  • Databases & Data Management
    • Heroku Postgres
      • Postgres Basics
      • Postgres Getting Started
      • Postgres Performance
      • Postgres Data Transfer & Preservation
      • Postgres Availability
      • Postgres Special Topics
      • Migrating to Heroku Postgres
    • Heroku Key-Value Store
    • Apache Kafka on Heroku
    • Other Data Stores
  • AI
    • Working with AI
  • Monitoring & Metrics
    • Logging
  • App Performance
  • Add-ons
    • All Add-ons
  • Collaboration
  • Security
    • App Security
    • Identities & Authentication
      • Single Sign-on (SSO)
    • Private Spaces
      • Infrastructure Networking
    • Compliance
  • Heroku Enterprise
    • Enterprise Accounts
    • Enterprise Teams
    • Heroku Connect (Salesforce sync)
      • Heroku Connect Administration
      • Heroku Connect Reference
      • Heroku Connect Troubleshooting
  • Patterns & Best Practices
  • Extending Heroku
    • Platform API
    • App Webhooks
    • Heroku Labs
    • Building Add-ons
      • Add-on Development Tasks
      • Add-on APIs
      • Add-on Guidelines & Requirements
    • Building CLI Plugins
    • Developing Buildpacks
    • Dev Center
  • Accounts & Billing
  • Troubleshooting & Support
  • Integrating with Salesforce
  • Language Support
  • .NET
  • Heroku .NET Support

Heroku .NET Support

Last updated April 01, 2025

Table of Contents

  • .NET Versions
  • Behavior
  • Customer Support
  • Additional Reading

Heroku supports .NET applications, including C#, Visual Basic, and F# projects using the .NET and ASP.NET Core frameworks version 8.0 and later. This document contains version support info.

To learn more about how Heroku recognizes and builds .NET applications, see .NET Behavior in Heroku.

To learn how to deploy a sample .NET app, check out the Getting Started with .NET on Heroku (Classic) or Getting Started with .NET on Heroku (Fir) tutorials.

.NET Versions

Heroku supports official .NET SDK releases. The published build artifact also includes the .NET and ASP.NET Core runtimes in the SDK release used to build an application.

Supported .NET Versions

The .NET buildpack supports C#, Visual Basic, and F# projects using the .NET and ASP.NET Core frameworks (version 8.0 and higher).

You can find a complete list of supported .NET SDK versions and platforms in the SDK inventory file.

Default .NET SDK Version Configuration

By default, the .NET buildpack installs the latest available and compatible .NET SDK version based on the TargetFramework property in each project file. The buildpack supports Target Framework Moniker (TFM) values in the format net{major_version}.0, for example, net8.0 and net9.0.

If a solution references projects targeting different framework versions, the buildpack prioritizes the most recent version when determining which SDK to install.

Advanced .NET SDK Version Configuration

To specify a different .NET SDK version, add a global.json file to the root directory. The buildpack supports configuring both the version and rollForward policy to control SDK installation. For example:

{
  "sdk": {
    "version": "8.0.106",
    "rollForward": "disable"
  }
}

Use the rollForward: disable option only when necessary, and regularly update the version to maintain security.

For general usage, we recommend setting rollForward to latestFeature.

.NET Version Policy

Heroku’s .NET support follows the official .NET support policy. We recommend using the latest patch release of a supported .NET version and upgrading before any version reaches end of support.

Behavior

See .NET Behavior in Heroku to learn more about how Heroku handles .NET applications.

Customer Support

You can submit issues via one of the Heroku Support channels.

Additional Reading

  • Getting Started on Heroku with .NET
  • Getting Started on Heroku Fir with .NET
  • .NET Behavior in Heroku

Keep reading

  • .NET

Feedback

Log in to submit feedback.

.NET Behavior in Heroku .NET Behavior in Heroku

Information & Support

  • Getting Started
  • Documentation
  • Changelog
  • Compliance Center
  • Training & Education
  • Blog
  • Support Channels
  • Status

Language Reference

  • Node.js
  • Ruby
  • Java
  • PHP
  • Python
  • Go
  • Scala
  • Clojure
  • .NET

Other Resources

  • Careers
  • Elements
  • Products
  • Pricing
  • RSS
    • Dev Center Articles
    • Dev Center Changelog
    • Heroku Blog
    • Heroku News Blog
    • Heroku Engineering Blog
  • Twitter
    • Dev Center Articles
    • Dev Center Changelog
    • Heroku
    • Heroku Status
  • Github
  • LinkedIn
  • © 2025 Salesforce, Inc. All rights reserved. Various trademarks held by their respective owners. Salesforce Tower, 415 Mission Street, 3rd Floor, San Francisco, CA 94105, United States
  • heroku.com
  • Legal
  • Terms of Service
  • Privacy Information
  • Responsible Disclosure
  • Trust
  • Contact
  • Cookie Preferences
  • Your Privacy Choices