Skip to content

docs(gen): tutorials review 2025-07-16 #5289

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jul 17, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ categories:
- apple-silicon
tags: cilicon continuous-integration
dates:
validation: 2024-12-24
validation: 2025-07-16
posted: 2023-12-14
---
import Requirements from '@macros/iam/requirements.mdx'
Expand Down
2 changes: 1 addition & 1 deletion tutorials/deploy-chatwoot-self-care/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ tags: chatwoot crm customer-service
categories:
- instances
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2023-05-16
---
import image from './assets/scaleway-chatwoot-dashboard.webp'
Expand Down
14 changes: 3 additions & 11 deletions tutorials/deploy-clickhouse-database/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ hero: assets/scaleway-clickhouse.webp
categories:
- instances
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2022-12-01
---
import Requirements from '@macros/iam/requirements.mdx'
Expand Down Expand Up @@ -48,20 +48,12 @@ ClickHouse® is an open-source column-oriented database management system that a
```
6. Start the ClickHouse server:
```
clickhouse start
./clickhouse server
```

7. Start the `clickhouse-client` with:
```
clickhouse-client --password
```
Enter the password when prompted:
```
root@scw-epic-chatelet:~# clickhouse-client --password
ClickHouse client version 24.6.1.3936 (official build).
Password for user (default):
Connecting to localhost:9000 as user default.
Connected to ClickHouse server version 24.6.1.
./clickhouse client
```

ClickHouse provides a wide range of demo datasets and tutorials to load and test the application. Visit the [official website](https://clickhouse.com/docs/en/getting-started/example-datasets/) and [documentation](https://clickhouse.com/docs/en/home/) for more information.
2 changes: 1 addition & 1 deletion tutorials/easydeploy-gitlab-runner/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ description: Learn how to deploy GitLab Runner on Scaleway Kubernetes clusters u
categories:
- kubernetes
dates:
validation: 2025-01-06
validation: 2025-07-16
posted: 2024-06-20
---
import Requirements from '@macros/iam/requirements.mdx'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ tags: encryption cilium kapsule wireguard
categories:
- kubernetes
dates:
validation: 2024-12-31
validation: 2024-07-16
posted: 2024-12-31
---
import Requirements from '@macros/iam/requirements.mdx'
Expand Down Expand Up @@ -43,7 +43,7 @@ The `CiliumNodeConfig` resource defines encryption settings for Cilium. It enabl
encrypt-node: "false"
```
<Message type="note">
* `matchLabels: {}` applies encryption to **all nodes** in the cluster.
* `matchLabels: {}` applies encryption to **all nodes** in the cluster.
* Adjust `nodeSelector` if you want to target specific nodes (e.g., nodes labeled `k8s.scaleway.com/managed: "true"`).
</Message>
2. Deploy the `CiliumNodeConfig` resource to your cluster using `kubectl`:
Expand Down
2 changes: 1 addition & 1 deletion tutorials/gitlab-instant-app/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ tags: apps GitLab InstantApp
categories:
- instances
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2015-05-07
---
import Requirements from '@macros/iam/requirements.mdx'
Expand Down
6 changes: 3 additions & 3 deletions tutorials/install-ispconfig/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,14 +6,14 @@ categories:
- domains-and-dns
tags: hosting ISPconfig Ubuntu Linux
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2019-01-25
---
import Requirements from '@macros/iam/requirements.mdx'


ISPConfig is an open-source, transparent, free, stable, and secure administration tool, available in more than 20 languages.
ISPConfig simplifies the management of various web hosting services such as DNS configuration, domain name management, email, or FTP file transfer.
ISPConfig is an open-source, transparent, free, stable, and secure administration tool, available in more than 20 languages.
ISPConfig simplifies the management of various web hosting services such as DNS configuration, domain name management, email, or FTP file transfer.
It can be used to manage a single server, multiple servers for larger setups, or even mirrored clusters.

<Requirements />
Expand Down
2 changes: 1 addition & 1 deletion tutorials/install-openlitespeed-wordpress/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ categories:
- instances
tags: OpenLiteSpeed Wordpress Ubuntu Bionic-Beaver php
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2019-08-07
---
import image from './assets/scaleway-ols_demo.webp'
Expand Down
2 changes: 1 addition & 1 deletion tutorials/install-openvpn/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ tags: vpn OpenVPN Ubuntu
categories:
- instances
dates:
validation: 2025-01-06
validation: 2025-07-16
posted: 2019-01-16
---
import Requirements from '@macros/iam/requirements.mdx'
Expand Down
2 changes: 1 addition & 1 deletion tutorials/install-wireguard/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ categories:
- instances
tags: vpn WireGuard Linux android
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2019-03-28
---
import image from './assets/scaleway-wg-android-home.webp'
Expand Down
2 changes: 1 addition & 1 deletion tutorials/installation-lemp-ubuntu-bionic/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ tags: LEMP-Stack Ubuntu-Bionic Linux Nginx MySQL PHP certbot
categories:
- instances
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2018-07-31
---
import image from './assets/scaleway-lemp-php72.webp'
Expand Down
2 changes: 1 addition & 1 deletion tutorials/installation-lemp-ubuntu-focal/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ tags: LEMP-Stack Ubuntu Linux Nginx MySQL PHP certbot
categories:
- instances
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2021-12-03
---
import image from './assets/scaleway-lemp-php72.webp'
Expand Down
2 changes: 1 addition & 1 deletion tutorials/k8s-gitlab/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ categories:
- kubernetes
- instances
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2020-06-09
---
import image from './assets/scaleway-token.webp'
Expand Down
2 changes: 1 addition & 1 deletion tutorials/k8s-velero-backup/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ categories:
- kubernetes
- object-storage
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2023-06-02
---
import image from './assets/scaleway-velero-backup-console.webp'
Expand Down
2 changes: 1 addition & 1 deletion tutorials/librenms-monitoring/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ tags: LibreNMS Ubuntu Focal-Fossa
categories:
- instances
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2019-07-04
---
import image from './assets/scaleway-librenms_install.webp'
Expand Down
2 changes: 1 addition & 1 deletion tutorials/magento-ubuntu/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ categories:
- instances
- domains-and-dns
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2020-06-17
---
import image from './assets/scaleway-magento_storefront.webp'
Expand Down
2 changes: 1 addition & 1 deletion tutorials/manage-database-instance-pgadmin4/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ categories:
- compute
- postgresql-and-mysql
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2019-10-28
---
import image from './assets/scaleway-pgadmin_login.webp'
Expand Down
2 changes: 1 addition & 1 deletion tutorials/manage-k8s-logging-loki/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ tags: Grafana Loki Kubernetes logs
categories:
- kubernetes
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2019-11-06
---
import Requirements from '@macros/iam/requirements.mdx'
Expand Down
2 changes: 1 addition & 1 deletion tutorials/mist-streaming-server/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ categories:
tags: streaming mist-server Mist OBS
hero: assets/scaleway_mistserver.webp
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2020-07-01
---
import image from './assets/scaleway-mistserver_01.webp'
Expand Down
2 changes: 1 addition & 1 deletion tutorials/mlx-array-framework-apple-silicon/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ categories:
- apple-silicon
tags: apple-silicon mlx framework apple mac-mini
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2023-12-15
---
import Requirements from '@macros/iam/requirements.mdx'
Expand Down
2 changes: 1 addition & 1 deletion tutorials/mongodb-ubuntu-1604/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ tags: database mysql mongoDB UFW bindIP
categories:
- instances
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2018-06-25
---
import Requirements from '@macros/iam/requirements.mdx'
Expand Down
2 changes: 1 addition & 1 deletion tutorials/monitor-k8s-grafana/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ categories:
tags: kubernetes kapsule Prometheus monitoring Grafana
hero: assets/scaleway_grafana.webp
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2020-03-18
---
import image from './assets/scaleway-prom1.webp'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ categories:
- instances
tags: LAN Rocket.Chat vpc
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2020-10-19
---
import image from './assets/scaleway-private_network_schema.webp'
Expand Down
2 changes: 1 addition & 1 deletion tutorials/object-storage-s3fs/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ tags: object-storage s3fs
categories:
- object-storage
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2018-07-16
---
import Requirements from '@macros/iam/requirements.mdx'
Expand Down
2 changes: 1 addition & 1 deletion tutorials/odoo/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ categories:
- elastic-metal
hero: assets/scaleway_odoo.webp
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2020-08-13
---
import image from './assets/scaleway-odoo14_install.webp'
Expand Down
2 changes: 1 addition & 1 deletion tutorials/openvpn-instant-app/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ tags: OpenVPN VPN Ubuntu InstantApp
categories:
- instances
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2015-06-11
---
import image from './assets/scaleway-tunnelblick03.webp'
Expand Down
2 changes: 1 addition & 1 deletion tutorials/overleaf/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ tags: media Overleaf ubuntu
categories:
- instances
dates:
validation: 2025-01-09
validation: 2025-07-16
posted: 2023-10-02
---
import Requirements from '@macros/iam/requirements.mdx'
Expand Down
36 changes: 24 additions & 12 deletions tutorials/s3cmd/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,6 @@ dates:
---
import Requirements from '@macros/iam/requirements.mdx'


In this tutorial, you will learn how to use [s3cmd](https://github.com/s3tools/s3cmd) as a client for [Scaleway Object Storage](/object-storage/concepts/#object-storage). `s3cmd` is a tool that allows you to create, list and delete buckets from the command line, as well as to download, upload, and delete objects to/from your buckets.

<Requirements />
Expand All @@ -35,14 +34,18 @@ You can install s3cmd from the command line using your Linux package manager.
```
</TabsTab>
<TabsTab label="OSX">
Run the following command to install s3cmd:
```bash
brew install s3cmd
```
1. Ensure Homebrew is updated by running:
```bash
brew update
```
2. Run the following command to install s3cmd:
```bash
brew install s3cmd
```
</TabsTab>
</Tabs>
<Message type="note">
At the time of writing, this installs version `2.4.0`. To install later versions of s3cmd, or to install on other operating systems, download directly from GitHub or SourceForge. See the official [s3cmd documentation](https://s3tools.org/download) for more help.
Check the installed version of s3cmd using `s3cmd --version` after installation. To install the latest version or for other operating systems, download directly from GitHub or SourceForge. See the official [s3cmd documentation](https://s3tools.org/download) for more help.
</Message>

## Configuring s3cmd
Expand All @@ -58,13 +61,13 @@ Carry out the following commands from your terminal.
```bash
nano .s3cfg
```
3. Copy and paste the following text into the file, then save and close. Make sure you use the `host-base`, `host-bucket`, and `bucket_location` details of your own bucket (visible in the **Bucket settings** tab of the console). You will also need to replace `<ACCESS_KEY>` and `<SECRET_KEY>` with your [own API credentials](/iam/how-to/create-api-keys/).
3. Paste the following text into the file, save your changes, and exit. Make sure you use the `host_base`, `host_bucket`, and `bucket_location` details of your own bucket (visible in the **Bucket settings** tab of the console). You will also need to replace `<ACCESS_KEY>` and `<SECRET_KEY>` with your [own API credentials](/iam/how-to/create-api-keys/).
```bash
[default]
# Object Storage Region NL-AMS

host_base = s3.nl-ams.scw.cloud
host_bucket = %(bucket).s3.nl-ams.scw.cloud
host_bucket = %(bucket)s.s3.nl-ams.scw.cloud
bucket_location = nl-ams
use_https = True

Expand All @@ -74,7 +77,7 @@ Carry out the following commands from your terminal.
secret_key = <SECRET_KEY>
```
<Message type="tip">
Alternatively, you can use the configuration file generator by running `s3cmd --configure` to generate a configuration file.
Alternatively, you can use the configuration file generator by running `s3cmd --configure` to generate a configuration file. You can also generate a configuration file using the Scaleway CLI with `scw object config get type=s3cmd region=nl-ams`.
</Message>

### Using multiple configuration files
Expand All @@ -97,14 +100,17 @@ Carry out the following steps from the terminal.
# Object Storage Region FR-PAR

bucket_location = fr-par
host_base = https://s3.fr-par.scw.cloud
host_bucket = https://s3.fr-par.scw.cloud
host_base = s3.fr-par.scw.cloud
host_bucket = %(bucket)s.s3.fr-par.scw.cloud

# Login credentials

access_key = <ACCESS_KEY>
secret_key = <SECRET_KEY>
```
<Message type="note">
The `signature = s3v4` line ensures compatibility with Scaleway’s S3 API, which uses AWS Signature Version 4. Alternatively, generate this configuration file using `scw object config get type=s3cmd region=fr-par`.
</Message>
4. Use s3cmd by specifying the new configuration file in the command:
```bash
s3cmd ls -c ~/.s3cfg-fr-par
Expand Down Expand Up @@ -152,6 +158,9 @@ photo1.jpg -> s3://mynewbucket/photo1.jpg [2 of 2]
```
We are currently working to correct this issue.
</Message>
<Message type="note">
For large files (>5GB), `s3cmd` supports multipart uploads, which Scaleway’s Object Storage handles with a limit of 1000 chunks. Adjust settings like `--multipart-chunk-size-mb` if needed.
</Message>

### Listing objects inside a bucket

Expand Down Expand Up @@ -239,6 +248,9 @@ The [CORS standard](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing)
```bash
s3cmd setcors cors.xml s3://bucketname
```
<Message type="note">
You can also manage CORS settings directly in the Scaleway console under the **Bucket Settings** tab, which is often easier than using XML files.
</Message>

### Deleting the CORS configuration of a bucket

Expand All @@ -249,7 +261,7 @@ s3cmd delcors s3://bucketname
```

<Message type="important">
It is currently not possible to get the CORS configuration of a bucket with `s3cmd`. It is recommended to use [aws-cli](/object-storage/api-cli/bucket-operations/#getbucketcors) to get the CORS settings of a bucket.
It is currently not possible to get the CORS configuration of a bucket with `s3cmd`. To retrieve CORS settings, use `aws s3api get-bucket-cors --bucket bucketname --endpoint-url https://s3.nl-ams.scw.cloud` with `aws-cli` configured for Scaleway.
</Message>

## Going further
Expand Down
2 changes: 1 addition & 1 deletion tutorials/scaleway-packer-plugin/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ categories:
- instances
tags: packer images instances
dates:
validation: 2025-01-02
validation: 2025-07-16
posted: 2023-06-06
---

Expand Down
Loading