[BUG] vscode-server does not start if IPv6 is not available

Is there an existing issue for this?

I have searched the existing issues

Current Behavior

The container fails to start on a host where IPv6 has been disabled.

Expected Behavior

The container should start.

Steps To Reproduce

Disable IPv6 on the Docker host
Start the container with the latest code-server image
The container fails to start due to being unable to bind to ":::8443"

Environment

- OS: Debian 11
- How docker service was installed: Official Debian package

CPU architecture

x86-64

Docker creation

services:
  code-server:
    image: linuxserver/code-server:4.127.0
    container_name: code-server
    hostname: code-server
    restart: unless-stopped
    volumes:
      - code-server:/config
      - code-server-data:/data
    environment:
      TZ: Europe/Berlin
      HASHED_PASSWORD: '<redacted>'
      DEFAULT_WORKSPACE: /data
    labels:
      traefik.enable: true
      traefik.http.routers.code-server.rule: "Host(`code-server.example.com`)"

Container logs

[2026-07-04T15:39:49.962Z] info  code-server 4.127.0 1e6ed874e3138141a5636f6e0dbe8570aa6cd001
[2026-07-04T15:39:49.963Z] info  Using user-data-dir /config/data
[2026-07-04T15:39:49.977Z] error listen EAFNOSUPPORT: address family not supported :::8443

Thanks for opening your first issue here! Be sure to follow the relevant issue templates, or risk having this issue marked as invalid.

Same issue here

I guess the merge from commit 84a119f is causing this.

At least give us env var for listening addr config. For now it wont start without ipv6 support, its broken.

Any fix for this issue? It has been a while....

There is a pull request to fix that (#219) but it hasn't been merged yet.

This issue has been automatically marked as stale because it has not had recent activity. This might be due to missing feedback from OP. It will be closed if no further activity occurs. Thank you for your contributions.

Is this image abandoned? Will this issue get fix? Please "_"

Fear no more for I have found an easy workaround to bring back VSCODE-SERVER from the dead without IPV6. If you have any trouble with it, let me know.

Run LinuxServer code-server Without IPv6

1. Create the Dockerfile

cat > Dockerfile <<'EOF'
FROM lscr.io/linuxserver/code-server:latest

RUN sed -i 's#\[::\]:8443#0.0.0.0:8443#g' \
    /etc/s6-overlay/s6-rc.d/svc-code-server/run
EOF

2. Build the derived image

docker build --no-cache --pull -t code-server-no-ipv6:latest .

3. Edit your Docker Compose file to use new image

    image: code-server-no-ipv6:latest #lscr.io/linuxserver/code-server:latest

*A successful startup should include:

Connection to 127.0.0.1 8443 port [tcp/*] succeeded!

Navigation Menu

Repository navigation

[BUG] vscode-server does not start if IPv6 is not available #218

Is there an existing issue for this?

Current Behavior

Expected Behavior

Steps To Reproduce

Environment

CPU architecture

Docker creation

Container logs

Run LinuxServer code-server Without IPv6

1. Create the Dockerfile

2. Build the derived image

3. Edit your Docker Compose file to use new image

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

[BUG] vscode-server does not start if IPv6 is not available #218

Description

Is there an existing issue for this?

Current Behavior

Expected Behavior

Steps To Reproduce

Environment

CPU architecture

Docker creation

Container logs

Activity

github-actions commented on Jul 4, 2026

MnM001 commented on Jul 5, 2026

pinguinfuss commented on Jul 6, 2026

madpeteguy commented on Jul 15, 2026

MnM001 commented on Aug 12, 2026

Programie commented on Aug 12, 2026

LinuxServer-CI commented on Sep 11, 2026

madpeteguy commented on Sep 11, 2026

KeepBitcoinFree-org commented on Sep 20, 2026

Run LinuxServer code-server Without IPv6

1. Create the Dockerfile

2. Build the derived image

3. Edit your Docker Compose file to use new image

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions