Skip to content

Commit 3a9268b

Browse files
bene2k1bene2k1
committed
feat(wbh): add troubleshooting
1 parent 28becc3 commit 3a9268b

File tree

7 files changed

+306
-0
lines changed

7 files changed

+306
-0
lines changed

‎menu/navigation.json

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2886,6 +2886,32 @@
28862886
],
28872887
"label": "Additional Content",
28882888
"slug": "reference-content"
2889+
},
2890+
{
2891+
"items": [
2892+
{
2893+
"label": "Troubleshooting cPanel or Plesk access issues",
2894+
"slug": "troubleshooting-access-issues-cpanel-plesk"
2895+
},
2896+
{
2897+
"label": "Troubleshooting mail or website access issues",
2898+
"slug": "cant-access-website-mail"
2899+
},
2900+
{
2901+
"label": "Troubleshooting DNS issues",
2902+
"slug": "troubleshooting-dns-issues"
2903+
},
2904+
{
2905+
"label": "Troubleshooting mail delivery issues",
2906+
"slug": "troubleshooting-email"
2907+
},
2908+
{
2909+
"label": "Troubleshooting FTP access issues",
2910+
"slug": "cant-connect-ftp"
2911+
}
2912+
],
2913+
"label": "Troubleshooting",
2914+
"slug": "troubleshooting"
28892915
}
28902916
],
28912917
"label": "Web Hosting",

‎pages/webhosting/troubleshooting/cant-access-website-mail.mdx

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
---
2+
meta:
3+
title: Troubleshooting mail or website access issues
4+
description: This page suggests solutions if you cannot access your mail or website.
5+
content:
6+
h1: Troubleshooting mail or website access issues
7+
paragraph: This page suggests solutions if you cannot access your mail or website.
8+
tags: web-hosting troubleshooting
9+
dates:
10+
validation: 2025-02-05
11+
posted: 2025-02-05
12+
categories:
13+
- webhosting
14+
---
15+
16+
## Problem
17+
You are unable to access your mail or website.
18+
19+
### Symptoms
20+
- The website does not load or shows an error.
21+
- Your domain does not resolve correctly.
22+
- You encounter connection timeouts or security warnings.
23+
24+
## Possible causes
25+
- DNS records are not set up correctly.
26+
- Your hosting service is experiencing downtime.
27+
- Your IP address may be blocked by a firewall.
28+
29+
## Solution
30+
31+
#### Check if DNS records are set up correctly or need time to propagate
32+
- Verify your domain's DNS records in [Scaleway’s DNS management interface](/webhosting/how-to/configure-dns-webhosting/).
33+
- Use a DNS checker (e.g., [whatsmydns.net - DNS Propagation Checker](https://www.whatsmydns.net/)) to ensure your domain resolves correctly.
34+
- If you've recently updated DNS settings, allow **up to 48 hours** for full propagation.
35+
36+
#### Check if firewall or security restrictions may prevent access
37+
- Try accessing your website from a different network or mobile data.
38+
- Ensure your site’s `.htaccess` or firewall rules do not unintentionally block access.
39+
40+
#### Check your email configuration for potential issues
41+
- Verify your [email settings](/webhosting/how-to/manage-email-accounts/) in your Web Hosting panel (SMTP, IMAP, and POP3 configurations).
42+
- Verify your [DNS settings](/webhosting/how-to/configure-dns-webhosting/) and ensure your domain has the correct **MX**, **SPF**, and **DKIM** records set up.
43+
- Check if your email client or ISP is blocking outgoing SMTP connections (use **port 587 or 465** instead of port 25).
44+
45+
#### Check if your SSL certificate may have expired or is not installed correctly
46+
- Check your SSL certificate status via an SSL checker tool (e.g., [SSL Labs](https://www.ssllabs.com/ssltest/)).
47+
- Renew or reinstall your SSL certificate in your hosting panel.
48+
- Ensure your domain is correctly configured for HTTPS in your website settings.
49+
50+
#### Check if your hosting server may be undergoing maintenance or experiencing downtime
51+
- Check Scaleway’s [status page](https://status.scaleway.com/) for any ongoing incidents.
52+
53+
### Additional troubleshooting steps
54+
- Clear your browser cache and DNS cache (`ipconfig /flushdns` on Windows or `sudo dscacheutil -flushcache` on macOS).
55+
- Test website access using an online proxy or VPN to rule out local ISP issues.
56+
- Check the complete documentation of [cPanel](https://docs.cpanel.net/cpanel/) or [Plesk](https://docs.plesk.com/en-US/obsidian/) for further information.
57+

‎pages/webhosting/troubleshooting/cant-connect-ftp.mdx

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
---
2+
meta:
3+
title: Troubleshooting FTP access issues
4+
description: This page suggests solutions if you cannot access your FTP account.
5+
content:
6+
h1: Troubleshooting FTP access issues
7+
paragraph: This page suggests solutions if you cannot access your FTP account.
8+
tags: web-hosting troubleshooting
9+
dates:
10+
validation: 2025-02-05
11+
posted: 2025-02-05
12+
categories:
13+
- webhosting
14+
---
15+
16+
## Problem
17+
I can't connect to my FTP account.
18+
19+
### Symptoms
20+
- FTP login fails with an authentication error.
21+
- Your FTP client cannot establish a connection.
22+
- File uploads or downloads are interrupted frequently.
23+
24+
## Possible causes
25+
- Incorrect FTP credentials.
26+
- Passive mode is required but not enabled.
27+
- Your firewall or ISP is blocking FTP ports.
28+
29+
## Solution
30+
31+
#### Check your FTP credentials
32+
- Double-check your FTP username, password, and hostname in your hosting panel.
33+
- Ensure you are using the correct protocol (FTP, SFTP) as required by your hosting provider.
34+
- If you recently [changed your password](/webhosting/how-to/manage-ftp-accounts/#how-to-update-the-password-of-an-ftp-account), update it in your FTP client.
35+
36+
#### Enable passive mode
37+
- Some networks require **passive mode** for FTP connections.
38+
- In your FTP client settings, look for a **Connection Mode** option and select **Passive Mode** instead of **Active Mode**.
39+
40+
#### Check firewall and network settings
41+
- Ensure port **21** (FTP) is open in your firewall settings.
42+
- Some ISPs block FTP connections; try switching to **SFTP** (port 22) if available.
43+
44+
#### Test with an alternative FTP client
45+
- If the issue persists, try using another FTP client (e.g., [FileZilla](https://filezilla-project.org/), [WinSCP](https://winscp.net/eng/index.php), or [Cyberduck](https://cyberduck.io/)) to rule out client-specific problems.
46+
47+
#### Restart your router and check ISP restrictions
48+
- Restart your router to refresh network settings.
49+
- Contact your ISP to confirm if FTP connections are restricted or blocked.
50+

‎pages/webhosting/troubleshooting/index.mdx

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
---
2+
meta:
3+
title: Web Hosting - Troubleshooting
4+
description: Troubleshoot common issues with Scaleway Web Hosting.
5+
content:
6+
h1: Web Hosting - Troubleshooting
7+
paragraph: Troubleshoot common issues with Scaleway Web Hosting.
8+
---

‎pages/webhosting/troubleshooting/troubleshooting-access-issues-cpanel-plesk.mdx

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
---
2+
meta:
3+
title: Troubleshooting cPanel or Plesk access issues
4+
description: This page suggests solutions if you cannot access cPanel or Plesk.
5+
content:
6+
h1: Troubleshooting cPanel or Plesk access issues
7+
paragraph: This page suggests solutions if you cannot access cPanel or Plesk.
8+
tags: web-hosting troubleshooting
9+
dates:
10+
validation: 2025-02-05
11+
posted: 2025-02-05
12+
categories:
13+
- web-hosting
14+
---
15+
16+
## Problem
17+
You are unable to log in to cPanel or Plesk (depending on your Web Hosting plan).
18+
19+
### Symptoms
20+
- Login attempts fail with incorrect credentials.
21+
- The login page does not load or times out.
22+
- An error message like "Invalid login" or "Too many failed attempts" appears.
23+
24+
## Possible causes
25+
- Incorrect username or password.
26+
- Your IP address is temporarily blocked due to multiple failed login attempts.
27+
- The cPanel or Plesk service is undergoing maintenance.
28+
- Your hosting plan has expired or is suspended.
29+
- A firewall or security setting is restricting access.
30+
31+
### Solution
32+
- Check the [service status page](https://status.scaleway.com/) for any ongoing maintenance or outages.
33+
- Reset your password using the password reset feature of your Web Hosting plan in the [Scaleway console](https://console.scaleway.com/webhosting/webhosting).
34+
- Try accessing cPanel/Plesk from a different network (e.g., using mobile data).
35+
- Disable any VPNs, proxies, or security software that might be blocking the connection.
36+
- Ensure your network allows access to ports used by cPanel (`2083`) and Plesk (`8443`).

‎pages/webhosting/troubleshooting/troubleshooting-dns-issues.mdx

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
meta:
3+
title: Troubleshooting DNS issues
4+
description: Solutions for common DNS-related issues in Scaleway Web Hosting.
5+
content:
6+
h1: Troubleshooting DNS issues
7+
paragraph: This guide provides solutions for common DNS issues encountered with Scaleway's Web Hosting product.
8+
tags: web-hosting troubleshooting DNS
9+
categories:
10+
- webhosting
11+
dates:
12+
validation: 2025-02-05
13+
posted: 2025-02-05
14+
---
15+
16+
## Problem
17+
You are experiencing DNS-related errors with your Scaleway Web Hosting service.
18+
19+
### Symptoms
20+
- Your domain does not resolve to the correct IP address.
21+
- You receive DNS resolution failures (e.g., `DNS_PROBE_FINISHED_NXDOMAIN`).
22+
- DNS changes take longer than expected to propagate.
23+
- Website remains inaccessible even after updating DNS records.
24+
25+
## Possible causes
26+
- Incorrect DNS settings configured in Scaleway Web Hosting.
27+
- Delayed DNS propagation due to TTL values.
28+
- Domain registrar nameservers not correctly set.
29+
- Caching issues affecting DNS resolution.
30+
31+
## Solution
32+
33+
#### Verify your DNS configuration
34+
- Ensure your domain points to the correct Scaleway Web Hosting IP.
35+
- Use Scaleway’s recommended nameservers and DNS settings.
36+
- Double-check that your A, CNAME, and MX records are properly set.
37+
- Refer to [Scaleway's DNS Configuration Guide](/webhosting/how-to/configure-dns-webhosting/) for details.
38+
39+
#### Check for conflicting DNS settings
40+
- Ensure no conflicting records exist (e.g., multiple A or CNAME records pointing to different servers).
41+
- Remove outdated or incorrect entries.
42+
43+
#### Allow time for DNS propagation
44+
- DNS changes can take up to 48 hours to propagate globally.
45+
- Check propagation status using tools like [DNSChecker](https://dnschecker.org/).
46+
47+
#### Clear DNS cache
48+
- On your local machine, flush the DNS cache:
49+
- Windows: Run `ipconfig /flushdns` in Command Prompt.
50+
- macOS: Run `sudo dscacheutil -flushcache` and `sudo killall -HUP mDNSResponder` in Terminal.
51+
- Linux: Restart the DNS service or use `sudo systemd-resolve --flush-caches`.
52+
- Restart your browser or try using a different network.
53+
54+
#### Test local DNS resolution
55+
Use the `nslookup` or `dig` command to check domain resolution.
56+
- Example:
57+
```sh
58+
nslookup yourdomain.com
59+
dig yourdomain.com +short
60+
```
61+
If incorrect records appear, wait for propagation or reconfigure your DNS settings.
62+

‎pages/webhosting/troubleshooting/troubleshooting-email.mdx

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
---
2+
meta:
3+
title: Troubleshooting mail delivery issues
4+
description: This page suggests solutions for common mail delivery problems.
5+
content:
6+
h1: Troubleshooting mail delivery issues
7+
paragraph: This page suggests solutions for common mail delivery problems.
8+
tags: web-hosting troubleshooting
9+
dates:
10+
validation: 2025-02-05
11+
posted: 2025-02-05
12+
categories:
13+
- webhosting
14+
---
15+
16+
## Problem
17+
You are facing you're experiencing issues with sending or receiving emails using your Web Hosting.
18+
19+
### Symptoms
20+
- Emails are not being received or sent.
21+
- Emails are landing in the spam folder instead of the inbox.
22+
- Your mail server rejects outgoing emails.
23+
- You receive bounce-back messages with error codes.
24+
25+
26+
## Possible causes & solutions
27+
28+
### Incorrect IMAP/POP3 configuration
29+
#### Cause
30+
Your email client or application may have incorrect IMAP/POP3 settings, preventing emails from being received.
31+
32+
#### Solution
33+
- Check your SMTP server address, port, and authentication method in your email client.
34+
- Use the correct SMTP settings provided for your mailbox:
35+
- **Incoming mail Server:** `yourdomain.com` *(or as provided by the instructions in your hosting panel)*
36+
- **Port:** `993` (IMAP, recommened) or `995` (POP3)
37+
- **Authentication:** Enabled (use your email credentials)
38+
- Ensure your firewall or ISP is not blocking any of these ports.
39+
40+
### Incorrect SMTP configuration
41+
#### Cause
42+
Your email client or application may have incorrect SMTP settings, preventing emails from being sent.
43+
44+
#### Solution
45+
- Check your SMTP server address, port, and authentication method in your email client.
46+
- Use the correct SMTP settings provided for your mailbox:
47+
- **SMTP Server:** `yourdomain.com` *(or as provided by the instructions in your hosting panel)*
48+
- **Port:** `465` (SSL)
49+
- **Authentication:** Enabled (use your email credentials)
50+
- Ensure your firewall or ISP is not blocking outgoing SMTP connections.
51+
52+
### Missing or incorrect SPF, DKIM, and DMARC records
53+
#### Cause:
54+
- If your domain lacks proper DNS records for email authentication, recipient mail servers may flag your emails as spam or reject them.
55+
56+
#### Solution
57+
Update your DNS zone with the recommended settings for your Web Hosting plan from the ***DNS verification** tab in the Scaleway console.
58+
59+
### IP Address blacklisted for spam activity
60+
#### Cause
61+
If your server's IP address has been flagged for sending spam, email providers may reject your messages.
62+
63+
#### Solution
64+
- Check if your IP is blacklisted using [MXToolbox Blacklist Checker](https://mxtoolbox.com/blacklists.aspx).
65+
- Scan your devices (desktop computers, laptops, mobile phones, ..) for malware or compromised email accounts.
66+
- If blacklisted, contact our [technical support](https://console.scaleway.com/support) for furher assistance.
67+
- *Optional:* Order a dedicated IP address in the Scaleway console, reserved for emails sent and received by domain names linked to your Web Hosting.

0 commit comments

Comments
 (0)