Skip to content

forwardPorts configuration option not working #186

Open

Description

@davidkron

With the recent release (the one with features) I tried experimenting with the devcontainers CLI. But I just can't get the forwardPorts feature to work. I created the following minimal devcontainer.json file:

{
  "name": "my-project-devcontainer",
  "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
  "features": {
    "ghcr.io/devcontainers/features/sshd:1": {
      "version": "latest"
    }
  },
  "forwardPorts": [2222],
  "remoteUser": "vscode"
}

Maybe I am misunderstanding the forwardPorts option, but I would expect that this configuration will forward the port 2222 (this is the default defined by the sshd feature) from the devcontainer to my host. But a simple ssh localhost -p 2222 did not work.

I tried this on Windows 11.

Activity

  1. Frankramos181422 commented on Sep 22, 2022

    @Frankramos181422

    With the recent release (the one with features) I tried experimenting with the devcontainers CLI. But I just can't get the forwardPorts feature to work. I created the following minimal devcontainer.json file:

    
    {
    
      "name": "my-project-devcontainer",
    
      "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
    
      "features": {
    
        "ghcr.io/devcontainers/features/sshd:1": {
    
          "version": "latest"
    
        }
    
      },
    
      "forwardPorts": [2222],
    
      "remoteUser": "vscode"
    
    }
    
    

    Maybe I am misunderstanding the forwardPorts option, but I would expect that this configuration will forward the port 2222 (this is the default defined by the sshd feature) from the devcontainer to my host. But a simple ssh localhost -p 2222 did not work.

    I tried this on Windows 11.

  2. chrmarti commented on Sep 23, 2022

    @chrmarti
    Contributor

    Port forwarding is currently not implemented in the CLI. Labelling as feature request.

  3. MunsMan commented on Feb 27, 2023

    @MunsMan

    Is there any information about the intent of adding Port Forwarding to the devcontainer CLI?

  4. michaelperel commented on Mar 6, 2023

    @michaelperel

    How are you supposed to expose ports, if the option is not supported in devcontainer.json? I have tried looking through the cli tool (most naturally would think it fits in devcontainer up), but have not found anything.

    Most simply, I am looking for something equivalent to docker run -p 8080:8080 ….

    Something like this feels crucial to support individuals that don’t use vscode, but would rather dev in the container with vim / emacs.

  5. MunsMan commented on Mar 6, 2023

    @MunsMan

    michaelperel, to my knowledge, port forwarding is not supported in the CLI via forward-port. You can use the appPort Option. I implemented basic port forwarding via the docker -p/--publish flag. Currently, it is still living here: https://github.com/MunsMan/devcontainercli/tree/port_forwarding
    I will do a pull request after I added some testing. If you like, I would love feedback.

    I truly agree that the Devcontainer CLI should support workflows independent of VS Code. I'm additionally developing auto-forwarding, but it will probably be a feature, which needs to be added to an Image. We will see.

  6. delijah commented on Oct 24, 2023

    @delijah

    Any progress on this? Would be awesome to get this feature!

  7. agilgur5 commented on Jul 16, 2024

    @agilgur5

    You can use the appPort Option. I implemented basic port forwarding via the docker -p/--publish flag. Currently, it is still living here: https://github.com/MunsMan/devcontainercli/tree/port_forwarding
    I will do a pull request

    I rebased this and made some minor modifications (simplifications and style etc) and put up a PR: #859

    I'm additionally developing auto-forwarding, but it will probably be a feature, which needs to be added to an Image. We will see.

    It looks like this was worked on in https://github.com/MunsMan/autoForward but was not completed?

    GitHub Codespaces does have auto-forwarding, which is nice, not sure if VSCode does as well.

    But while related, that's a separate feature from supporting plain forwardPorts

  8. threema-danilo commented on Jan 7, 2026

    @threema-danilo

    This is a duplicate of #22, right?

  9. collimarco commented on Jun 12, 2026

    @collimarco

    Is this issue still open after so many years? Has anyone found a solution or workaround?

    Otherwise it seems impossible to use this CLI and an editor different from VS code...

  10. candidtim commented on Jun 16, 2026

    @candidtim

    Is this issue still open after so many years? Has anyone found a solution or workaround?

    Otherwise it seems impossible to use this CLI and an editor different from VS code...

    appPort works as a workaround. It is not quite the same, though. One caveat to know about: the application running in the container would need to list on 0.0.0.0 for this to work.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions