How to change the port number for Asp.Net core app?

Question

I added the following section in project.json.

  "commands": {
    "run": "run server.urls=http://localhost:8082",
    "web": "Microsoft.AspNet.Hosting --server Microsoft.AspNet.Server.Kestrel --server.urls http://localhost:8082",
    "weblistener": "Microsoft.AspNet.Hosting --server WebListener --server.urls http://localhost:8082"
  },

However, it still shows "Now listening on: http://localhost:5000" when run it using dotnet myapp.dll?

BTW, will clients from other machine be able to access the service?

The `"commands"` property is not used by `dotnet` anymore, which explains why it doesn't work. — svick, Aug 04 '16 at 11:32
[Config port in appsettings.json](https://stackoverflow.com/a/55276201/2934730) — menxin, Mar 26 '19 at 14:17

score 76 · Answer 1 · edited Mar 13 '21 at 23:03

Yes this will be accesible from other machines if you bind on any external IP address. For example binding to http://*:80 . Note that binding to http://localhost:80 will only bind on 127.0.0.1 interface and therefore will not be accesible from other machines.

Visual Studio is overriding your port. You can change VS port editing this file Properties\launchSettings.json or else set it by code:

        var host = new WebHostBuilder()
            .UseKestrel()
            .UseContentRoot(Directory.GetCurrentDirectory())
            .UseIISIntegration()
            .UseStartup<Startup>()
            .UseUrls("http://localhost:80") // <-----
            .Build();

        host.Run();

A step by step guide using an external config file is available here.

This was essentially what I had to do to get my app to run in Docker... although in that scenario, I did it by setting the environment variable ASPNETCORE_URLS to `http://*:80`, and _not_ `http://localhost:80`. You made my day, thank you! — JamesQMurphy, Sep 20 '22 at 19:36

score 66 · Answer 2 · answered Jul 27 '19 at 10:45

It's working to me.

I use Asp.net core 2.2 (this way supported in asp.net core 2.1 and upper version).

add Kestrel section in appsettings.json file. like this:

{
  "Kestrel": {
    "EndPoints": {
      "Http": {
        "Url": "http://localhost:4300"
      }
    }
  },
  "Logging": {
    "LogLevel": {
      "Default": "Warning"
    }
  },
  "AllowedHosts": "*"
}

and in Startup.cs:

public Startup(IConfiguration configuration, IHostingEnvironment env)
{
      var builder = new ConfigurationBuilder()
         .SetBasePath(env.ContentRootPath)
         .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
         .AddEnvironmentVariables();

      Configuration = builder.Build();
}

And `"Url": "http://*:80"` for public facing (don't use for production but useful to for example demo something to a client) — Ruslan, Mar 25 '20 at 04:16

score 56 · Answer 3 · answered Mar 28 '21 at 21:41

56

Use simply dotnet YouApp.dll --urls http://0.0.0.0:80.

P.S. I don't know why I need to google this everytime and everytime it doesn't show up. So here it is.

answered Mar 28 '21 at 21:41

Tom Charles Zhang

871
9
11

Did not work for me, using dotnet 6. Project still trying to run on the default port (5000 in my case). – Sheldonfrith Jan 11 '23 at 18:41
1

@Sheldonfrith Makes no sense. I use the same command on ASP.Net Core 3.1 and ASP.Net Core 6. They all work. It's explicitly stated as one of the ways to configure port on ASP.Net Core 7 documentation: https://learn.microsoft.com/en-us/aspnet/core/fundamentals/servers/kestrel/endpoints?view=aspnetcore-7.0 You might check whether you have configured ASPNETCORE_URLS which may cause conflicts. – Tom Charles Zhang Jan 27 '23 at 04:10

score 30 · Answer 4 · answered Apr 12 '18 at 11:32

30

In Asp.net core 2.0 WebApp, if you are using visual studio search LaunchSettings.json. I am adding my LaunchSettings.json, you can change port no as u can see.

answered Apr 12 '18 at 11:32

GirishBabuC

1,267
15
20

score 17 · Answer 5 · answered Mar 22 '19 at 11:51

17

In visual studio 2017 we can change the port number from LaunchSetting.json

In Properties-> LaunchSettings.json.

Open LaunchSettings.json and change the Port Number.

Change the port Number in json file

answered Mar 22 '19 at 11:51

Sathish

2,029
15
13

Akshay Vijay Jain · Answer 6 · 2019-05-10T06:23:26.877

16

Use following one line of code .UseUrls("http://*:80") in Program.cs

Thus changing .UseStartup<Startup>()

to

.UseStartup<Startup>() .UseUrls("http://*:80")

edited May 10 '19 at 06:23

answered May 01 '19 at 05:53

Akshay Vijay Jain

13,461
8
60
73

Aditya Y · Answer 7 · 2020-12-31T12:57:17.360

3 files have to changed appsettings.json (see the last section - kestrel ), launchsettings.json - applicationurl commented out, and a 2 lines change in Startup.cs

Add below code in appsettings.json file and port to any as you wish.

  },

 "Kestrel": {

   "Endpoints": {

     "Http": {

       "Url": "http://localhost:5003"

     }

   }

 }

 }

Modify Startup.cs with below lines.

using Microsoft.AspNetCore.Server.Kestrel.Core;

services.Configure<KestrelServerOptions>(Configuration.GetSection("Kestrel"));

score 10 · Answer 8 · answered May 08 '21 at 05:46

10

will clients from other machine be able to access the service?

add to appsettings.json

  "Urls": "http://0.0.0.0:8082",

answered May 08 '21 at 05:46

Shaybakov

618
7
9

score 9 · Answer 9 · answered Jan 27 '19 at 08:59

9

We can use this command to run our host project via Windows Powershell without IIS and visual studio on a separate port. Default of krestel web server is 5001

$env:ASPNETCORE_URLS="http://localhost:22742" ; dotnet run

answered Jan 27 '19 at 08:59

Abdus Salam Azad

5,087
46
35

score 9 · Answer 10 · answered Apr 09 '19 at 14:53

Go to your program.cs file add UseUrs method to set your url, make sure you don't use a reserved url or port

 public class Program
    {
        public static void Main(string[] args)
        {
            BuildWebHost(args).Run();
        }

        public static IWebHost BuildWebHost(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseStartup<Startup>()

                // params string[] urls
                .UseUrls(urls: "http://localhost:10000")

                .Build();
    }

Kols · Answer 11 · 2019-08-07T05:35:37.553

6

All the other answer accounts only for http URLs. If the URL is https, then do as follows,

Open launchsettings.json under Properties of the API project.
Change the sslPort under iisSettings -> iisExpress

A sample launchsettings.json will look as follows

{
  "iisSettings": {
    "iisExpress": {
      "applicationUrl": "http://localhost:12345",
      "sslPort": 98765 <== Change_This
    }
  },

edited Aug 07 '19 at 05:35

answered May 13 '19 at 09:42

Kols

3,641
2
34
42

Leniel Maccaferri · Answer 12 · 2023-06-05T22:13:55.283

6

Building on @Abdus Salam Azad's answer...

In Visual Studio 2022 if you right click an ASP.NET Core Web API project for example, you have access to this UI where you can set up ASPNETCORE variables like this:

There you can enter a custom URL:port for ASPNETCORE_URLS like this:

https://localhost:44777

edited Jun 05 '23 at 22:13

answered Oct 04 '22 at 21:45

Leniel Maccaferri

100,159
46
371
480

score 3 · Answer 13 · answered Dec 19 '20 at 06:00

3

in appsetting.json

{ "DebugMode": false, "Urls": "http://localhost:8082" }

answered Dec 19 '20 at 06:00

mostafa kazemi

514
6
7

score 3 · Answer 14 · answered Nov 02 '22 at 15:07

The following works in ASP.Net Core 6.0. Inside Program.cs have this:

var builder = WebApplication.CreateBuilder(args);

if (!app.Environment.IsDevelopment())
{
    builder.WebHost.UseUrls("http://*:80", "https://*.443");
}

I find it is useful to wrap it in a conditional statement when publishing to production, but this isn't necessary.

This works running from a Kestrel server on Mac OS 12.

score 1 · Answer 15 · answered Aug 04 '16 at 07:06

you can also code like this

        IConfiguration config  = new ConfigurationBuilder()
        .AddCommandLine(args)
        .Build(); 
        var host = new WebHostBuilder()
         .UseConfiguration(config)
         .UseKestrel()
         .UseContentRoot(Directory.GetCurrentDirectory()) 
         .UseStartup<Startup>()
         .Build();

and set up your application by command line :dotnet run --server.urls http://*:5555

score 1 · Answer 16 · answered Mar 25 '20 at 07:35

1

in your hosting.json replace"Url": "http://localhost:80" by"Url": "http://*:80" and you will be able now access to your application by http://your_local_machine_ip:80 for example http://192.168.1.4:80

answered Mar 25 '20 at 07:35

Amara Miloudi

122
1
6

score 1 · Answer 17 · edited Sep 01 '20 at 22:32

1

Maybe it's because I am not using Core yet. My project didn't have a LaunchSettings.json file but that did prompt me to look in the project properties. I found it under the Web tab and simply changed the project url:

edited Sep 01 '20 at 22:32

Chris Catignani

5,040
16
42
49

answered May 16 '20 at 16:00

Anthony Griggs

1,469
2
17
39

HirenP · Answer 18 · 2020-07-15T19:32:35.770

If you want to run on a specific port 60535 while developing locally but want to run app on port 80 in stage/prod environment servers, this does it.

Add to environmentVariables section in launchSettings.json

"ASPNETCORE_DEVELOPER_OVERRIDES": "Developer-Overrides",

and then modify Program.cs to

public static IHostBuilder CreateHostBuilder(string[] args) =>
            Host.CreateDefaultBuilder(args)
                .ConfigureWebHostDefaults(webBuilder =>
                {
                    webBuilder.UseKestrel(options =>
                    {
                        var devOverride = Environment.GetEnvironmentVariable("ASPNETCORE_DEVELOPER_OVERRIDES");
                        if (!string.IsNullOrWhiteSpace(devOverride))
                        {
                            options.ListenLocalhost(60535);
                        }
                        else
                        {
                            options.ListenAnyIP(80);
                        }
                    })
                    .UseStartup<Startup>()
                    .UseNLog();                   
                });

score 1 · Answer 19 · answered Nov 30 '21 at 14:14

I had a similar issue with a Kubernetes deployment after upgrading to .NET 6. The solution was simply to add the following environment variable to the deployment:

- name: Kestrel__Endpoints__Http__Url
  value: http://0.0.0.0:80

This will work anywhere else where you can use an environment variable

Yarden zamir · Answer 20 · 2022-07-10T19:00:54.163

1

In asp.net core 6
app.Run("https://*:25565");
or in my case for deploying on heroku
app.Run("https://*:"+Environment.GetEnvironmentVariable("PORT"));

edited Jul 10 '22 at 19:00

answered Jul 10 '22 at 19:00

Yarden zamir

21
2

score 1 · Answer 21 · answered Sep 20 '22 at 17:47

Core 6.0 --> Without any JSON setting changes we do some thing like this.. I also commented some code bcoz I don't have certificate. we can run it any port.

 builder.WebHost.ConfigureKestrel((context, serverOptions) =>
            {
               // serverOptions.Listen(System.Net.IPAddress.Loopback, 5003);
                serverOptions.Listen(System.Net.IPAddress.Loopback, 8086, listenOptions =>
            {
                listenOptions.UseHttps();
              //listenOptions.UseHttps("testCert.pfx", "testPassword");
            });
        });

score 0 · Answer 22 · answered Jan 11 '22 at 13:02

I created my project using Visual Studio 2022, so in Project/Properties/launchSettings.json there are two parts for this topic: 1- for lunching in IISExpress :

"iisSettings": {
..
"iisExpress": {
  "applicationUrl": "http://localhost:31520",
  "sslPort": 44346
}

},

2- for lunching through IDE:

"profiles": {
"MaxTemplate.API": {
  ...
  "applicationUrl": "https://localhost:7141;http://localhost:5141",
  ...
  }
},

For example you can change the port 7141 to 5050 and run the project again.

Codingwiz · Answer 23 · 2022-11-02T16:51:58.810

Don't have enough rep to add this as a comment, but I want to add that the WebHost.UseUrls() in .net core 6 can be set using a combination of IPAddress and IPEndPoint in file Program.cs

if (!builder.Environment.IsDevelopment()) // app in release
{
               // listen to any ip on port 80 for http
    IPEndPoint ipEndPointHttp = new IPEndPoint(IPAddress.Any, 80),
           
               // listen to any ip on port 443 for https
               ipEndPointHttps = new IPEndPoint(IPAddress.Any, 443);

    builder.WebHost.UseUrls($"http://{ipEndPointHttp}",
                            $"https://{ipEndPointHttps}");

    // enforce ssl when in release
    builder.Services.AddHsts(options =>
    {
        options.Preload = true;
        options.IncludeSubDomains = true;
        options.MaxAge = TimeSpan.FromDays(3); // a commonly used value is one year.
    });

    // redirect to specific https port
    builder.Services.AddHttpsRedirection(options =>
    {
        options.RedirectStatusCode = (int)HttpStatusCode.PermanentRedirect;
        options.HttpsPort = ipEndPointHttps.Port;
    });
}
else // app in debug
{
               // listen to localhost on port 8081 for http
    IPEndPoint ipEndPointHttp = new IPEndPoint(IPAddress.Loopback, 8081),

               // listen to localhost on port 5001 for https
               ipEndPointHttps = new IPEndPoint(IPAddress.Loopback, 5001);

    builder.WebHost.UseUrls($"http://{ipEndPointHttp}",
                            $"https://{ipEndPointHttps}");

    // redirect to specific https port
    builder.Services.AddHttpsRedirection(options =>
    {
        options.RedirectStatusCode = (int)HttpStatusCode.TemporaryRedirect;
        options.HttpsPort = ipEndPointHttps.Port;
    });
}

... // rest of configuration

app.UseHttpsRedirection(); // set redirection to https if url is in http

....

Also note that using these values new IPEndPoint(IPAddress.Any, 80), *:80, ::80 are all equivalent, but I prefer IPEndPoint since it is more verbose

If a custom ip address (ex: 192.168.1.200) is needed other than IPAddress.Any or IPAddress.Loopback, a new address can be set using IPAddress.Parse("192.168.1.200")

score 0 · Answer 24 · answered Mar 18 '23 at 07:06

0

go to launchsettings.json and change all the ports you can see there, including the ones in the IIS section

answered Mar 18 '23 at 07:06

Marco Montebello

1

2

Your answer could be improved with additional supporting information. Please [edit] to add further details, such as citations or documentation, so that others can confirm that your answer is correct. You can find more information on how to write good answers [in the help center](/help/how-to-answer). – Community Mar 23 '23 at 11:05

How to change the port number for Asp.Net core app?

24 Answers24

Linked

Related