Skip to content

Commit 1d56090

Browse files
committed
docs(srv): add info on supported http protocols MTA-6409
1 parent ac3fbeb commit 1d56090

File tree

10 files changed

+68
-0
lines changed

10 files changed

+68
-0
lines changed

pages/serverless-containers/concepts.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -285,3 +285,7 @@ Unit used to measure the resource consumption of a container. It reflects the am
285285
## Protocol
286286

287287
Serverless Containers supports **http1** (default) and **http2** (`h2c`). Use HTTP/2 if your container application is configured to listen for HTTP/2 requests, such as a **gRPC** service or a web server that uses HTTP/2 features like multiplexing, otherwise, HTTP/1 is recommended.
288+
289+
<Message type="note">
290+
HTTP/1.0 is not supported. Refer to the [dedicated troubleshooting page](/serverless-containers/troubleshooting/http1-errors/) for more information.
291+
</Message>

pages/serverless-containers/faq.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -235,6 +235,10 @@ Serverless Containers support **http1** and **http2**. **http1** is enabled by d
235235

236236
You can [modify the protocol](/serverless-containers/how-to/manage-a-container/#manage-a-deployment-from-the-scaleway-container-registry) used by your container from the **Requests tab** of the **Advanced options**.
237237

238+
<Message type="note">
239+
HTTP/1.0 is not supported. Refer to the [dedicated troubleshooting page](/serverless-containers/troubleshooting/http1-errors/) for more information.
240+
</Message>
241+
238242
### Why does my gRPC container not respond?
239243

240244
Containers use **http1** by default, yet the gRPC protocol requires `http2`. You can upgrade the protocol to `http2` (`h2c`).

pages/serverless-containers/reference-content/containers-limitations.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -82,6 +82,10 @@ Do not have your containers listen on these ports, as they are used by our servi
8282

8383
**Not available:** Serverless products are designed to abstract away infrastructure management, to be easily scalable, and to be cost-efficient and simple. So dedicated IPs are not supported for this product.
8484

85+
### Protocols
86+
87+
Serverless Containers support HTTP/1.1 and HTTP/2 connections. HTTP/1.0 is not supported. Refer to the [dedicated troubleshooting page](/serverless-containers/troubleshooting/http1-errors/) for more information on how to solve HTTP/1.0 issues.
88+
8589
## Private Networks and Virtual Private Cloud (VPC)
8690

8791
Refer to the [dedicated documentation](/serverless-containers/reference-content/containers-private-networks/) on VPC and Serverless Containers integration for more information.
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
---
2+
title: Solving HTTP/1.0 issues
3+
description: This page provides solutions to issues encountered while using HTTP/1.0 with Scaleway Serverless Containers
4+
tags: issues error protocol http1.0 http0.9 backwards compatibiliy
5+
dates:
6+
validation: 2025-08-25
7+
posted: 2025-08-25
8+
---
9+
10+
## Problem
11+
12+
I get an `HTTP 426 Upgrade Required` error while using Serverless Containers.
13+
14+
## Cause
15+
16+
Scaleway Serverless Containers only supports **HTTP/1.1** and **HTTP/2**. Other protocols are not compatible.
17+
18+
## Solutions
19+
20+
- Send **HTTP/1.1** requests if you have control over the protocol to use when calling a Serverless Container.
21+
- Deploy a layer in front of your container to translate HTTP/1.0 into HTTP/1.1.

pages/serverless-containers/troubleshooting/index.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,4 +68,5 @@ productIcon: ContainersProductIcon
6868
- [I am experiencing clock drift with my Serverless Containers](/serverless-containers/troubleshooting/container-clock-drift)
6969
- [I am experiencing DNS issues with my container](/serverless-containers/troubleshooting/known-dns-containers-errors/)
7070
- [I cannot access my container](/serverless-containers/troubleshooting/cannot-access-container/)
71+
- [I get errors when using HTTP/1.0](/serverless-containers/troubleshooting/http1-errors/)
7172
</LinksList>

pages/serverless-functions/concepts.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -126,6 +126,10 @@ Previously, Private Networks at Scaleway were zoned. Only resources from within
126126
While DHCP is built into all new Private Networks, it may not be automatically activated for older Private Networks. Check our [migration](/vpc/reference-content/vpc-migration/) documentation for more information.
127127
</Message>
128128

129+
## Protocol
130+
131+
Serverless Functions support **HTTP/1.1** and **HTTP/2**. Other protocols are not supported. Refer to the [dedicated troubleshooting page](/serverless-functions/troubleshooting/http1-errors/) for more information.
132+
129133
## Queue trigger
130134

131135
A queue trigger is a mechanism that connects a function to a queue created with [Scaleway Queues](/queues/concepts/#scaleway-queues), and invokes the function automatically whenever a message is added to the queue.

pages/serverless-functions/faq.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -253,6 +253,10 @@ You cannot use Serverless Functions with Edge Services because there are no nati
253253

254254
By design, it is not possible to guarantee static IPs on Serverless Compute resources.
255255

256+
### Which protocols are supported by Serverless Functions?
257+
258+
Serverless Functions support **HTTP/1.1** and **HTTP/2**. Other protocols are not supported. Refer to the [dedicated troubleshooting page](/serverless-functions/troubleshooting/http1-errors/) for more information.
259+
256260
### How can I attach Block Storage to a Serverless Function?
257261

258262
Scaleway Serverless Functions do not currently support attaching Block Storage. These functions are designed to be

pages/serverless-functions/reference-content/functions-limitations.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,10 @@ Due to potential abuse (spam), no outbound traffic is allowed through following
6464

6565
**Not available:** Serverless products are designed to abstract away infrastructure management, to be easily scalable, and to be cost-efficient and simple. So dedicated IPs are not supported for this product.
6666

67+
### Protocols
68+
69+
Serverless Functions support **HTTP/1.1** and **HTTP/2**. Other protocols are not supported. Refer to the [dedicated troubleshooting page](/serverless-functions/troubleshooting/http1-errors/) for more information.
70+
6771
## Private Networks and Virtual Private Cloud (VPC)
6872

6973
Refer to the [dedicated documentation](/serverless-functions/reference-content/functions-private-networks/) on VPC and Serverless Functions integration for more information.
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
---
2+
title: Solving HTTP/1.0 issues
3+
description: This page provides solutions to issues encountered while using HTTP/1.0 with Scaleway Serverless Functions
4+
tags: issues error protocol http1.0 http0.9 backwards compatibiliy
5+
dates:
6+
validation: 2025-08-25
7+
posted: 2025-08-25
8+
---
9+
10+
## Problem
11+
12+
I get an `HTTP 426 Upgrade Required` error while using Serverless Functions.
13+
14+
## Cause
15+
16+
Scaleway Serverless Functions only supports **HTTP/1.1** and **HTTP/2**. Other protocols are not compatible.
17+
18+
## Solutions
19+
20+
- Send **HTTP/1.1** requests if you have control over the protocol to use when calling a Serverless Function.
21+
- Deploy a layer in front of your function to translate HTTP/1.0 into HTTP/1.1.

pages/serverless-functions/troubleshooting/index.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,4 +69,5 @@ productIcon: FunctionsProductIcon
6969
- [I am experiencing timeout errors](/serverless-functions/troubleshooting/timeout-error)
7070
- [My function fails after trying too many times](/serverless-functions/troubleshooting/too-many-retries)
7171
- [I am experiencing clock drift with my Serverless Functions](/serverless-functions/troubleshooting/function-clock-drift)
72+
- [I get errors when using HTTP/1.0](/serverless-functions/troubleshooting/http1-errors/)
7273
</LinksList>

0 commit comments

Comments
 (0)