OS Not Recognized - Oracle Linux 8 - Failure to Connect Remote Workspace in VSCode
- Dominant language
- TypeScript
- Stars
- 2k
- Forks
- 807
- Avg merge
- 10h 12m
- Merged PRs (30d)
- 7
Description
## Problem
AWS Toolkit works fine to access remote ec2/ecs instances through ssm, giving access to the shell using ssm-user. However, when we try to attach the workspace to the remote instance, it fails complaining that cannot recognize the OS Name "Oracle Linux 8", which is based on RHEL and similar (or even identical) to CentOS 8.
## Steps to reproduce the issue
1. Connect to AWS Toolkit.
2. Navigate to EC2 -> (any instance) -> click on Connect VS Code to EC2 Instance.
Error message:
```
Unrecognized OS name Oracle Linux Server on instance i-1234567890abcdefg
```
Full log:
```
[info] Command: (not started) [/usr/local/bin/bash -i -l -c '/home/ndsadmin/.vscode-server/bin/(...)/node' -p '"(...)" + JSON.stringify(process.env) + "(...)"']
2025-06-09 13:31:41.358 [warning] getUnixShellEnvironment#stderr:bash: cannot set terminal process group (-1): Inappropriate ioctl for device
bash: no job control in this shell
2025-06-09 13:31:41.358 [info] Command: (not started) [sessionmanagerplugin/bin/session-manager-plugin --version]
2025-06-09 13:31:41.374 [info] Command: (not started) [/home/ndsadmin/.vscode-server/data/User/globalStorage/amazonwebservices.aws-toolkit-vscode/tools/Amazon/sessionmanagerplugin/bin/session-manager-plugin --version]
2025-06-09 13:32:06.436 [info] telemetry: sent batch (size=20)
2025-06-09 13:32:06.531 [info] telemetry: sent batch (size=20)
2025-06-09 13:32:06.590 [info] telemetry: sent batch (size=15)
2025-06-09 13:32:35.080 [error] aws.ec2.openRemoteConnection: Error: Unrecognized OS name Oracle Linux Server on instance i-1234567890abcdefg [UnknownEc2OS]
```
## Expected behavior
To be able to connect with workspace to any EC2 instances or ECS tasks' containers.
## System details (run `AWS: About` and/or `Amazon Q: About`)
- OS: Oracle Linux 8 / RHEL (similar to CentOS)
- Visual Studio Code version: 1.85.2 (Universal)
- AWS Toolkit version: v3.64.0
- Amazon Q version: N/A
Details found in the `/etc/release-os`:
```
NAME="Oracle Linux Server"
VERSION="8.10"
ID="ol"
ID_LIKE="fedora"
VARIANT="Server"
VARIANT_ID="server"
VERSION_ID="8.10"
PLATFORM_ID="platform:el8"
PRETTY_NAME="Oracle Linux Server 8.10"
ANSI_COLOR="0;31"
CPE_NAME="cpe:/o:oracle:linux:8:10:server"
HOME_URL="https://linux.oracle.com/"
BUG_REPORT_URL="https://github.com/oracle/oracle-linux"
ORACLE_BUGZILLA_PRODUCT="Oracle Linux 8"
ORACLE_BUGZILLA_PRODUCT_VERSION=8.10
ORACLE_SUPPORT_PRODUCT="Oracle Linux"
ORACLE_SUPPORT_PRODUCT_VERSION=8.10
```
Command `uname -a`:
```
Linux ip-10-XXX-XX-XXX.ec2.internal 4.18.0-553.51.1.el8_10.x86_64 #1 SMP Wed Apr 30 02:25:35 PDT 2025 x86_64 x86_64 x86_64 GNU/Linux
```
Contributor guide
Research direction
Start by tracing the aws.ec2.openRemoteConnection failure and the OS detection used for EC2 remote workspace connections. Reproduce with an Oracle Linux 8 instance, compare its release information with supported systems, and verify that the workspace connection succeeds without the UnknownEc2OS error.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- aws, linux, typescript, vscode
- Domain
- cloud, devtools, operating-systems
- Issue type
- Bug
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 42/100