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 65 · Answer 1 · edited Mar 13 '21 at 23:03

65

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.

edited Mar 13 '21 at 23:03

Sridhar Ratnakumar

75,681
63
142
179

answered Aug 04 '16 at 00:18

Gerardo Grignoli

12,593
6
52
61

1

In addition, one can check the Microsoft's reference on overriding configuration at [Overriding configuration](https://docs.microsoft.com/en-us/aspnet/core/fundamentals/hosting?view=aspnetcore-2.1&tabs=aspnetcore2x#overriding-configuration) – Ivan Maia May 09 '18 at 20:50
1

This statement helped me: **You can change VS port by editing** `Properties\launchSettings.json` You can define a new launch profile, add a Firewall exception, then have the front end developer use your live server as the two of you make changes together. – Zachary Scott Mar 07 '22 at 19:24

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

47

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();
}

answered Jul 27 '19 at 10:45

AminRostami

2,196
3
19
41

2

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
Error CS0104 'IHostingEnvironment' is an ambiguous reference between 'Microsoft.AspNetCore.Hosting.IHostingEnvironment' and 'Microsoft.Extensions.Hosting.IHostingEnvironment' – MindRoasterMir Mar 12 '21 at 20:06
@MindRoasterMir; `IHostingEnvironment` is referenced from `Microsoft.AspNetCore.Hosting`. – AminRostami Mar 13 '21 at 04:56

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

31

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

576
6
10

2

You're not alone. Because all developers have the question: How can change WebAPI port But Microsoft said: Add the urls param – Võ Quang Hòa Jan 17 '22 at 03:49

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

25

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,091
13
19

3

Girish Babu when i am updating the port number and running the application it throwing me the error in popup saying "Unable to connect to web server "IIS Express" , how to resolve this? – Rohit Sharma Aug 03 '19 at 13:58
@RohitSharma, another process on your computer may be using the updated port number. Try a different number. – Theophilus Feb 11 '22 at 15:35

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

16

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

1,911
12
13

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

15

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

9,370
6
44
50

score 8 · Answer 7 · 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();
    }

Aditya Y · Answer 8 · 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 6 · Answer 9 · answered Jan 27 '19 at 08:59

6

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

4,110
40
28

Kolappan N · Answer 10 · 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

Kolappan N

2,875
2
31
38

score 6 · Answer 11 · answered May 08 '21 at 05:46

6

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

500
5
7

This tweak works great in ASP.NET Core in .NET 5 – HakuteiJ Aug 13 '21 at 10:33
Did not work for me (ASP.NET Core 5) – Daniel Hillebrand Oct 14 '21 at 09:20

score 2 · Answer 12 · answered Mar 25 '20 at 07:35

2

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

104
1
6

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

2

in appsetting.json

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

answered Dec 19 '20 at 06:00

mostafa kazemi

257
3
6

This works for me, You saved my days!, Thanks – Harshad Prajapati Apr 13 '22 at 19:24

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

1

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

answered Aug 04 '16 at 07:06

liam

29
4

Nice! But this only works from command line. Do you know how/why from Visual Studio the port is overriden? – Gerardo Grignoli Aug 04 '16 at 22:16
ConfigurationBuilder hasn't definition AddCommandLine. Curtains down. – alerya Apr 05 '17 at 03:13
@GerardoGrignoli If launching you app from within Visual Studio, the Properties/launchSettings.json file will be used to set the url and port. – EL MOJO Aug 16 '17 at 23:32

score 1 · Answer 15 · 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

4,580
11
39
46

answered May 16 '20 at 16:00

Anthony Griggs

1,339
2
15
36

score 1 · Answer 16 · 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

HirenP · Answer 17 · 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 0 · Answer 18 · 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.

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

18 Answers18

Linked

Related