[BUG] vscode-server does not start if IPv6 is not available
Nobody has claimed this yet.
Assessment
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Newbie friendliness
- 65/100
- Issue type
- Bug
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- docker
- Domain
- devops
Research direction
Start by reproducing the failure with the provided Docker service configuration on a host with IPv6 disabled, then trace the code-server container startup path that attempts to bind to :::8443. Done means the latest code-server image starts successfully without IPv6 while retaining its expected access behavior; verify with the container logs and the same reproduction steps.
Written by the indexing model from the issue text.
Description
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
- Dominant language
- Dockerfile
- Stars
- 2k
- Forks
- 368
- PR merge metrics
- No merged PRs in 30d
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Similar issues
-
kind/bug needs-triage
Difficulty 1/5 Under an hour Newbie friendliness 72/100
matrixorigin/matrixone#29223 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
copse-dev/agent-pane#2953 ·
-
bug ci-failure high priority
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
vllm-project/vllm-omni#7972 · 1 comment ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 90/100
simonw/sqlite-utils#872 ·
-
bug good first issue
Difficulty 1/5 Under an hour Newbie friendliness 88/100
amponce/archive-movie-browser#166 ·