Skip to content

Commit 72a7e3f

Browse files
karibouLouis Bouchardnerda-codes
authored
fix(instances): Document api-metadata as a cause of problem with SSH … (#5490)
* fix(instances): Document api-metadata as a cause of problem with SSH keys * Apply suggestions from code review --------- Co-authored-by: Louis Bouchard <[email protected]> Co-authored-by: Néda <[email protected]>
1 parent 2b7a8b6 commit 72a7e3f

File tree

1 file changed

+11
-1
lines changed

1 file changed

+11
-1
lines changed

pages/instances/troubleshooting/fix-common-issues.mdx

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -84,6 +84,7 @@ This page lists the most common issues you may encounter with your Scaleway Inst
8484
- Wrong username: Using `root` versus a custom user.
8585
- Misconfiguration of the SSH daemon: `sshd_config` might disallow key-based authentication.
8686
- Key not installed: The public key might not have been successfully added to the Instance.
87+
- No access to Scaleway's api-metadata: Api-metadata is responsible for loading the SSH keys.
8788

8889
### Solution
8990
- Check file permissions locally:
@@ -100,6 +101,15 @@ This page lists the most common issues you may encounter with your Scaleway Inst
100101
- Re-add your SSH Key in the Scaleway console:
101102
- Go to the [SSH keys](https://console.scaleway.com/project/ssh-keys) tab in the **Project** section of theScaleway console, remove the old SSH key, then add your new, correct public key.
102103
- Restart your Instance to re-upload the list of allowed SSH keys.
104+
- Make sure that your Instance has access to the api-metadata by running the following command in the serial console:
105+
```bash
106+
# curl http://169.254.42.42/
107+
```
108+
The following output should display:
109+
```json
110+
{"api": "api-metadata", "description": "Metadata API, just query http://169.254.42.42/conf or http://169.254.42.42/conf?format=json to get info about yourself", "version": "12.23.0"}
111+
```
112+
No output means that access to the api-metadata is blocked. Identify the reason for the block and try running the command above again.
103113

104114
### Additional resources
105115
- [Scaleway Documentation: How to generate an SSH key pair](/organizations-and-projects/how-to/create-ssh-key/)
@@ -287,4 +297,4 @@ This page lists the most common issues you may encounter with your Scaleway Inst
287297
## Next steps
288298

289299
- Always consult the official [Scaleway Instances Documentation](/instances/) for detailed, up-to-date information to troubleshoot your Instance.
290-
- If you are still experiencing issues after following these tips, open a [support ticket](https://console.scaleway.com/support) in your Scaleway console, providing detailed descriptions of your issue, logs, screenshots, or error messages. This will help the Support team diagnose and resolve your issue more quickly.
300+
- If you are still experiencing issues after following these tips, open a [support ticket](https://console.scaleway.com/support) in your Scaleway console, providing detailed descriptions of your issue, logs, screenshots, or error messages. This will help the Support team diagnose and resolve your issue more quickly.

0 commit comments

Comments
 (0)