chore(review): tutos part 1 (#4975)

Author: nerda-codes

tutorials/configure-nextcloud-ubuntu/assets/scaleway-nextcloud-files.webp

@@ -9,7 +9,7 @@ categories:
   - instances
 tags: Nextcloud Ubuntu-Bionic-Beaver
 dates:
-  validation: 2024-10-29
+  validation: 2025-05-14
   posted: 2018-10-26
 ---
 
@@ -39,30 +39,25 @@ It provides a large portfolio of [different applications](https://nextcloud.com/
     ```
     snap install nextcloud
     ```
-4. Finish the installation by running the following command. Note that a username and password must be provided when you run the script.
+4. Run the following command to finish the installation. Make sure that you replace `your-username` and `your-password` with credentials of your choice, and that you note them as you will need them to login to your Nextcloud Instance.
     ```
-    nextcloud.manual-install user password
+    nextcloud.manual-install your-username your-password
     ```
 
-    <Message type="important">
-      Replace `user` with the identifier of your user and `password` with the password of your user in the command above.
-    </Message>
+    The following output should display:
 
-    You will see the following message:
-
-    `Nextcloud is not installed - only a limited number of commands are available`
-
-    Some minutes later the following message appears: `Nextcloud was successfully installed`. Your Nextcloud installation has been successful.
+    `Nextcloud was successfully installed`
 
 ## Configuring trusted domains
 
-By the default, the access to your Nextcloud Instance is limited to `localhost`. To access it via your domain name, you have to add it to the list of trusted domains.
+By default, access to your Nextcloud Instance is limited to `localhost`. To access it via your domain name, you have to add it to the list of trusted domains.
 
-1. Run the following command to allow the connection via the domain `your.domain.com` to your Nextcloud.
+Run the following command to allow the connection via the domain `your.domain.com` to your Nextcloud.
     ```
     nextcloud.occ config:system:set trusted_domains 1 --value=your.domain.com
     ```
-2. The following message appears when the domain is successfully added: `System config value trusted_domains => 1 set to string your.domain.com`
+
+The following message should appear, confirming that the domain was added: `System config value trusted_domains => 1 set to string your-domain.com`
 
 ## Securing the web interface with a Let's Encrypt TLS/SSL certificate
 
@@ -102,25 +97,26 @@ By default, the Nextcloud installation via Snap provides a plain HTTP connection
 
     Have you met these requirements? (y/n)
     ```
-3. Enter your email address when asked to do so and confirm by pressing **Enter**:
+3. Enter your email address when prompted and confirm by pressing **Enter**:
     ```
     Please enter an email address (for urgent notices or key recovery): [email protected]
     ```
 4. Enter the domain name that you have configured in a previous step for your Instance (`your.domain.com` in our case), then confirm by pressing **Enter**:
     ```
     Please enter your domain name(s) (space-separated): your.domain.com
     ```
-5. Your certificate is being requested and Apache will be restarted. The following messages will appear, once the certificate has been obtained:
+The following output should display once the certificate has been obtained:
     ```
     Attempting to obtain certificates... done
     Restarting apache... done
     ```
 
 ## Accessing Nextcloud
 
-You will now be able to access your Nextcloud Instance for the first time.
+You can now access your Nextcloud Instance.
 
-1. Open your browser and type the address of your Instance (For example: `https://your.domain.com`). You will see a login screen where you have to enter the user and password that you have created previously.
-2. Once connected you will see your personal cloud storage space. You can upload, share, or download files from the interface:
-    <Lightbox src="scaleway-nextcloud_files.webp" alt="" />
-3. Optionally, you can download one of the several [Nextcloud clients](https://nextcloud.com/install/#install-clients) to manage your cloud storage space directly from your computer.
+1. Open your browser and type the address of your Instance (For example: `https://your.domain.com`). A login screen displays.
+2. Enter the username and password that you have created in the previous steps. Your personal cloud storage space displays.
+3. Upload, share, or download files from the interface:
+    <Lightbox src="scaleway-nextcloud-files.webp" alt="" />
+4. Optionally, download one of the several [Nextcloud clients](https://nextcloud.com/install/#install-clients) to manage your cloud storage space directly from your computer.

tutorials/configure-nextcloud-ubuntu/assets/scaleway-nextcloud_files.webp

@@ -10,7 +10,7 @@ categories:
   - transactional-email
   - instances
 dates:
-  validation: 2025-05-14
+  validation: 2025-05-22
   posted: 2024-04-24
 ---
 
@@ -25,7 +25,7 @@ dates:
 
 1. [Create an API key](/iam/how-to/create-api-keys/) from the Scaleway console. Make sure that you take note of your secret key.
 2. [Create an Instance](/instances/how-to/create-an-instance/) with a **WordPress** image from the **InstantApps** tab.
-3. [Create](/instances/how-to/use-security-groups/#how-to-create-a-security-group) a security group, check the **Enable SMTP ports** box, click **+ Add Instance**, and select your Instance in the drop-down.
+3. [Create](/instances/how-to/use-security-groups/#how-to-create-a-security-group) a security group, choose your Instance to it to the security group, and check the **Enable SMTP ports** box.
 
 ## Configuring and logging in to your WordPress website
 
@@ -47,15 +47,15 @@ dates:
 
 ## Configuring the WordPress plug-in
 
-1. Hover over **WP Mail SMTP** in the WordPress left-side menu, and click **Settings**. You are redirected to the **General** tab.
+1. Click **Settings** under **WP Mail SMTP**. You are redirected to the **General** tab.
 2. Click the **Launch Setup Wizard** button to configure the plug-in. You are redirected to the WP Mail SMTP welcome page.
 3. Click **Let's Get Started**.
 4. Choose **Other SMTP**, then click **Save and Continue**.
 5. Enter `smtp.tem.scaleway.com` in the **SMTP Host** field.
 6. Select **TLS** in the **Encryption** field.
 7. In the **SMTP Port** enter either of the Transactional Email TLS connection ports: `465` or `2465`.
 8. Switch on the **Enable Authentication** toggle.
-9. Retrieve your **SMTP username** in the **Overview** tab of your Transactional Email domain in the Scaleway console, and paste it in the **SMTP Username** field.
+9. Access your [Transactional Email domain](https://console.scaleway.com/transactional-email/domains), retrieve your **Username** in the **SMTP configuration** section of the **Overview** tab, and paste it in the **SMTP Username** field.
     <Lightbox src="scaleway-smtp-config.webp" width="" alt="" />
 10. Use your Scaleway API secret key as your SMTP password.
 11. Enter the name you want your emails to originate from in the **From Name** field.

tutorials/configure-nextcloud-ubuntu/index.mdx

@@ -22,59 +22,58 @@ In this tutorial, you learn how to deploy your own Penpot Instance using the Doc
 
 - A Scaleway account logged into the [console](https://console.scaleway.com)
 - [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
- 
-## Installing Penpot using Docker Compose 
+- [Created a Scaleway Instance](/instances/how-to/create-an-instance/) with a [Docker InstantApp](https://console.scaleway.com/instance/servers/create?area=fr-par-1&imageKey=c1b530d8-0ca0-45c4-80db-ba06608287b2&offerName=PLAY2-MICRO)
+- A domain
 
-1. Click **Instances** in the **Compute** section of the [Scaleway console](https://console.scaleway.com/organization) side menu. Then [deploy](/instances/how-to/create-an-instance/) a new Instance using the [Docker InstantApp](https://console.scaleway.com/instance/servers/create?area=fr-par-1&imageKey=c1b530d8-0ca0-45c4-80db-ba06608287b2&offerName=PLAY2-MICRO).
+## Installing Penpot using Docker Compose
 
-2. Connect to the Instance using [SSH](/instances/how-to/connect-to-instance/):
+1. Connect to your Instance using [SSH](/instances/how-to/connect-to-instance/):
     ```
     ssh root@<docker_instance_ip>
     ```
 
-3. Download the Docker configuration from the Penpot repository:
+2. Download the Docker configuration from the Penpot repository:
 
     ```
     wget https://raw.githubusercontent.com/penpot/penpot/main/docker/images/docker-compose.yaml
-    wget https://raw.githubusercontent.com/penpot/penpot/main/docker/images/config.env
     ```
 
-4. Open the file containing the environment variables (`config.env`) in a text editor:
+3. Open `docker-compose.yaml` in a text editor:
     ```
-    nano config.env
+    nano docker-compose.yaml
     ```
 
-5. Set the `PENPOT_PUBLIC_URI` to your Penpot domain. Then save the file and exit the editor.
+4. Set the `PENPOT_PUBLIC_URI` to your Penpot domain. Then save the file and exit the editor.
     ```
-    PENPOT_PUBLIC_URI=https://penpot.mydomain.eu
+    PENPOT_PUBLIC_URI=https://penpot.your-domain.com
     ```
-6. Update the APT package cache on your system to make sure you have the latest releases available.
+5. Update the APT package cache on your system to make sure you have the latest releases available.
     ```
     apt update
     ```
 
-7. Install the Nginx web server and `certbot` using APT. These serve as a frontend for the Penpot application and provide a secured TLS connection by using Let's Encrypt certificates.
+6. Install the Nginx web server and `certbot` using APT. These serve as a frontend for the Penpot application and provide a secured TLS connection by using Let's Encrypt certificates.
     ```
     apt install nginx python3-certbot-nginx
     ```
 
-8. Disable the default virtual host, that is pre-configured when Nginx is installed via Ubuntu’s package manager.
+7. Disable the default virtual host, that is pre-configured when Nginx is installed via Ubuntu’s package manager.
     ```
     unlink /etc/nginx/sites-enabled/default
     ```
 
-9. Create a Nginx configuration file for the reverse proxy:
+8. Create an Nginx configuration file for the reverse proxy:
     ```
     nano /etc/nginx/sites-available/penpot.conf
     ```
 
-    Copy the following content into the file, save it, and exit the editor.
+9. Paste the following content into the file. Make sure that you replace `your-domain.com` with your domain. Save the file and exit.
     ```
     server {
             listen 80;
             listen [::]:80;
 
-            server_name  penpot.mydomain.eu;
+            server_name  penpot.your-domain.com;
 
             access_log /var/log/nginx/reverse-access.log;
             error_log /var/log/nginx/reverse-error.log;
@@ -104,11 +103,16 @@ In this tutorial, you learn how to deploy your own Penpot Instance using the Doc
 
 ## Securing the connection using TLS
 
-1. Run `certbot`, a tool that automatizes most of the configuration work related to requesting, installing, and managing the TLS certificate:
+1. Log into your domain registrar, access your DNS zone, and add an A record with the following information.
+        - Name: `penpot`
+        - IP address or Hostname or Value: `<your-instance-public-IPv4-address>`
+        - TTL: default
+
+2. Run `certbot`, a tool that automatizes most of the configuration work related to requesting, installing, and managing the TLS certificate:
     ```
     certbot --nginx
     ```
-2. Answer the prompts that display on the screen to request a valid Let’s Encrypt TLS certificate:
+3. Answer the prompts that display on the screen to request a valid Let’s Encrypt TLS certificate:
     ```
     Saving debug log to /var/log/letsencrypt/letsencrypt.log
     Plugins selected: Authenticator nginx, Installer nginx
@@ -121,7 +125,7 @@ In this tutorial, you learn how to deploy your own Penpot Instance using the Doc
     blank to select all options shown (Enter 'c' to cancel): 1
     Obtaining a new certificate
     Performing the following challenges:
-    http-01 challenge for your.domain.com
+    http-01 challenge for your-domain.com
     Waiting for verification...
     Cleaning up challenges
     Deploying Certificate to VirtualHost /etc/nginx/sites-enabled/reverse-proxy.conf
@@ -137,26 +141,24 @@ In this tutorial, you learn how to deploy your own Penpot Instance using the Doc
     Redirecting all traffic on port 80 to ssl in /etc/nginx/sites-enabled/reverse-proxy.conf
 
     - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-    Congratulations! You have successfully enabled https://your.domain.com
-
-    You should test your configuration at:
-    https://www.ssllabs.com/ssltest/analyze.html?d=your.domain.com
+    Congratulations! You have successfully enabled HTTPS on https://your-domain.com
     - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
     ```
 
-## Running Penpot 
+## Running Penpot
 
 1. Run `docker-compose` to start Penpot:
     ```
     docker-compose -p penpot -f docker-compose.yaml up -d
     ```
-2. Run the following command to add a Penpot user:
+2. Open your Penpot Instance in a browser:
     ```
-    docker exec -ti penpot-penpot-backend-1 ./manage.sh create-profile
+    http://penpot.your-domain.com
     ```
-3. Open a web browser on your local computer and point it to your Penpot domain. The login screen displays.
-    <Lightbox src="scaleway-penpot-login.webp" alt="" />
-4. Log in using the credentials of the previously created user. The Penpot dashboard displays. You can now start designing your assets. 
+3. Click **Create an account**.
+4. Enter an email address and a password, then click **Create an account**.
+    <Lightbox src="scaleway-penpot-account-creation.webp" alt="" />
+5. Enter a name and click **Create an account** again to confirm. The Penpot dashboard displays. You can now start designing your assets.
     <Lightbox src="scaleway-penpot-dashboard.webp" alt="" />
 
-Your Penpot Instance is now ready. For a more advanced configuration of additional features, refer to the [official documentation](https://help.penpot.app/technical-guide/configuration/).
+For a more advanced configuration of additional features, refer to the [official documentation](https://help.penpot.app/technical-guide/configuration/).