docs(aps): init docs runners (#5923)

bene2k1 · web-flow · commit 996cef61367c · 2025-12-10T10:37:04.000+01:00
* docs(aps): init docs runners

* docs(aps): update wording

* docs(aps): update wording

* docs(aps): fix typo

* docs(aps): wording

* docs(aps): add instructions for github token retrieval

* docs(aps): update doc

* docs(aps): devos

* docs(aps): update
diff --git a/pages/apple-silicon/concepts.mdx b/pages/apple-silicon/concepts.mdx
@@ -28,6 +28,12 @@ It is important to note that the commitment applies only to the server. Options,
   Currently, it is not possible to switch from a monthly commitment to hourly billing.
 </Message>
 
+## Dev OS
+
+Dev OS is a developer-optimized operating system based on a recent version of macOS. It is pre-configured with a set of development tools, runtimes, and dependencies, aligned with the software stack used in [GitHub Actions runner images](https://github.com/actions/runner-images/blob/main/images/macos/macos-15-Readme.md)).
+
+The purpose of Dev OS is to streamline onboarding, improve development efficiency, and reduce environment-related discrepancies by providing a uniform, production-like setup for all developers.
+
 ## Mac mini
 
 The Mac mini is a physical hardware designed by Apple, powered by the [Apple silicon](#apple-silicon) chip. It is the basis for Scaleway's [Apple silicon as-a-service](#apple-silicon-as-a-service) offer.
diff --git a/pages/apple-silicon/how-to/assets/scaleway_github_token.webp b/pages/apple-silicon/how-to/assets/scaleway_github_token.webp
diff --git a/pages/apple-silicon/how-to/create-mac-mini.mdx b/pages/apple-silicon/how-to/create-mac-mini.mdx
@@ -28,12 +28,7 @@ This page shows how to create your first [Mac mini](/apple-silicon/concepts/#mac
     </Message>
 2. Click **Create Mac mini**. The Mac mini creation wizard displays.
 3. Complete the following steps in the wizard:
-    - Select the commitment plan for your Mac mini. Two options are available:
-       - **No commitment:** You can terminate the subscription of your Mac mini at any time after the initial 24 hours, a mandatory period required by Apple's software license. [Learn more about Apple's software license requirements (Section 3.A)](https://www.apple.com/legal/sla/docs/macOSSequoia.pdf).
-       - **Commitment:** You subscribe to a [commitment plan for Apple silicon](/apple-silicon/concepts/#commitment-plan) and benefit from a discounted monthly price based on your choice.
-      <Message type="important">
-        Currently, it is not possible to switch from a monthly commitment to hourly billing.
-      </Message>
+    - Choose the **Standard** setup type for your Mac mini.
     - Choose an **Availability Zone**, which is the geographical region where your Mac mini will be deployed. The available Mac mini configurations depend on the Availability Zone:
       - Mac mini M4, M2 pro, and M2 are available in PARIS 1
       - Mac mini M1 are available in PARIS 3
@@ -42,8 +37,16 @@ This page shows how to create your first [Mac mini](/apple-silicon/concepts/#mac
     - Choose whether to activate the **Private Networks 1 Gbps** feature. This lets you attach your Mac mini to one or more Scaleway Private Networks in a [VPC](/vpc/), enabling secure communication with other attached resources.
     - Enter a **Name** for your Mac mini, or leave the randomly-generated name in place.
     - Verify the **Estimated cost** for your Mac mini based on your chosen specifications.
+    - Select the commitment plan for your Mac mini. Two options are available:
+      - **No commitment:** You can terminate the subscription of your Mac mini at any time after the initial 24 hours, a mandatory period required by Apple's software license. [Learn more about Apple's software license requirements (Section 3.A)](https://www.apple.com/legal/sla/docs/macOSSequoia.pdf).
+      - **Commitment:** You subscribe to a [commitment plan for Apple silicon](/apple-silicon/concepts/#commitment-plan) and benefit from a discounted monthly price based on your choice.
+      <Message type="important">
+        Currently, it is not possible to switch from a monthly commitment to hourly billing.
+      </Message>
 4. Tick the checkbox to agree to the Bare Metal specific conditions and the macOS License Agreement.
 5. Click **Create Mac mini** to finish. The installation of your Apple silicon is launched, and you are informed when it is ready.
+
+
     <Message type="note">
       Mac mini and macOS are trademarks of Apple Inc., registered in the U.S. and other countries and regions. IOS is a trademark or registered trademark of Cisco in the U.S. and other countries and is used by Apple under license. Scaleway is not affiliated with Apple Inc.
     </Message>
diff --git a/pages/apple-silicon/how-to/create-runner.mdx b/pages/apple-silicon/how-to/create-runner.mdx
@@ -0,0 +1,112 @@
+---
+title: How to create a GitHub / GitLab runner on Apple silicon
+description: Learn more about creating a GitHub or GitLab runner on a hosted Mac mini.
+tags: apple-silicon runner gitlab github
+dates:
+  validation: 2025-12-05
+  posted: 2025-12-05
+---
+import Requirements from '@macros/iam/requirements.mdx'
+import image from './assets/scaleway_github_token.webp'
+
+
+You can install your Mac mini with a pre-installed runner for GitHub or GitLab thanks to [Scaleway's Dev OS](/apple-silicon/reference-content/scaleway-dev-os/).
+
+<Message type="important">
+  If you wish to switch from **Runner** mode to [**Standard** mode](/apple-silicon/how-to/create-mac-mini/) (or vice versa), you must delete you current Mac mini and place a new order with the desired configuration. Mode changes cannot be performed in-place.
+</Message>
+
+<Requirements />
+
+- 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
+- An [SSH key](/organizations-and-projects/how-to/create-ssh-key/)
+
+<Message type="important">
+  Due to license constraints, the minimum lease for Apple silicon is 24 hours. As a result, the earliest you can delete a Mac mini is 24 hours after the start of its lease.
+</Message>
+
+## Creating a runner
+
+1. Click [Apple silicon](https://console.scaleway.com/asaas/servers) in the **Bare Metal** section of the side menu. The [Apple silicon splash page](https://console.scaleway.com/asaas/servers) displays.
+    <Message type="note">
+    Should your account already contain Mac minis, a list of these will be displayed rather than the Apple silicon splash page.
+    Alongside, you will see a (+ Create Mac mini) button, which you can click to create a new Mac mini.
+    </Message>
+2. Click **Create Mac mini**. The Mac mini creation wizard displays.
+3. Complete the following steps in the wizard:
+    - Choose the **Pre-installed runner** setup type for your Mac mini.
+    - Choose an **Availability Zone**, which is the geographical region where your Mac mini will be deployed. The available Mac mini configurations depend on the Availability Zone:
+    - Mac mini M4, M2 pro, and M2 are available in PARIS 1
+        <Message type="note">
+          Dev OS is ***not compatible** with with M1 Mac minis and machines equipped with less than **512 GB** of storage.
+        </Message>
+    - Choose a [Dev OS](/apple-silicon/reference-content/scaleway-dev-os/) version.
+    - Tick the checkbox to accept the Dev OS license agreement.
+    - Choose and configure your runner.
+      - **GitHub**: Enter your repository URL, registration token, and a runner name.
+      - **GitLab**: Enter your Instance URL, runner token, and a runner name.
+        <Message type="tip">
+            * Credentials are validated during runner installation. If incorrect credentials are provided, the runner **will still be created but will be non-functional**. You will be able to [update your credentials](#updating-a-runner) post-installation.
+            * GitHub tokens have a limited validity of one hour. If your token has expired it will not be possible to register your runner. You have to [retrieve a new token](#retrieving-your-github-token).
+        </Message>
+    - Enter a **Name** for your Mac mini, or leave the randomly-generated name in place.
+    - Verify the **Estimated cost** for your Mac mini based on your chosen specifications.
+    - Select the commitment plan for your Mac mini. Two options are available:
+      - **No commitment:** You can terminate the subscription of your Mac mini at any time after the initial 24 hours, a mandatory period required by Apple's software license. [Learn more about Apple's software license requirements (Section 3.A)](https://www.apple.com/legal/sla/docs/macOSSequoia.pdf).
+      - **Commitment:** You subscribe to a [commitment plan for Apple silicon](/apple-silicon/concepts/#commitment-plan) and benefit from a discounted monthly price based on your choice.
+        <Message type="important">
+            Currently, it is not possible to switch from a monthly commitment to hourly billing.
+        </Message>
+4. Tick the checkbox to agree to the Bare Metal specific conditions and the macOS License Agreement.
+5. Click **Create Mac mini** to finish. The installation of your Apple silicon is launched, and you are informed when it is ready.
+
+### Retrieving your GitHub token
+
+You can retrieve the required registration token to configure your self-hosted runner from your GitHub repository.
+
+1. Open your GitHub repository in a web browser.
+2. Click **Settings** to view the settings tab.
+3. In the **Actions** section of the sidebar, click **Runners** to display all runners configured for this project.
+4. Click **New self-hosted runner** to view the setup instructions.
+5. Retrieve the token from the command in the **Configure** section of the instructions.
+    For example, if the command appears as:
+    ```
+    $ ./config.sh --url https://github.com/my-user/my-github-repository/ --token 123456789abcdef123456789abcdef123456789a
+    ```
+    The token is the value after `--token`, like: `123456789abcdef123456789abcdef123456789a`.
+
+    <Lightbox image={image} size="medium" alt="A screenshot of the GitHub.com interface for adding new runners." />
+
+    <Message type="tip">
+      The registration token is **single-use** and **expires one hour after generation**. Do not share it or publish it publically.
+    </Message>
+
+## Updating a runner
+
+1. Click [Apple silicon](https://console.scaleway.com/asaas/servers) in the **Bare Metal** section of the side menu. The Apple silicon splash page displays.
+2. Select the machine you want to update. The runner information overview displays.
+3. Open the **Settings** tab.
+4. Click **Edit** in the **Runner information** section of the page. A pop-up displays.
+<Message type="tip">
+  GitHub tokens have a limited validity of one hour. If your token has expired it will not be possible to register your runner. You have to [retrieve a new token](#retrieving-your-github-token).
+</Message>
+5. Update your runner credentials and click **Save and reboot**. Your runner configuration will be updated and the runner performs a reboot to take the new configuration into effect.
+
+<Message type="tip">
+Runners relies on dev OS releases & are not kept up to date automatically. Once the runner is delivered you are responsible for keeping the preinstalled software up to date. In order to simplify maintenant of your runner fleet, we recommend personalizing your runners using CICD jobs. This way you can easily dispose of existing runners running outdated versions & replace them with new ones
+</Message>
+
+
+## Reinstalling a runner
+
+Reinstalling a server delivered in Dev OS mode is **not possible** due to the lengthy installation process required for the full Dev OS stack.
+You have to delete the runner and [create a new one](#creating-a-runner).
+
+## Deleting a runner
+
+You can delete a runner like any Mac mini. Refer to [How to delete a Mac mini](/apple-silicon/how-to/delete-mac-mini) for further information. 
+
+<Message type="note">
+  Mac mini and macOS are trademarks of Apple Inc., registered in the U.S. and other countries and regions. IOS is a trademark or registered trademark of Cisco in the U.S. and other countries and is used by Apple under license. Scaleway is not affiliated with Apple Inc.
+</Message>
diff --git a/pages/apple-silicon/menu.ts b/pages/apple-silicon/menu.ts
@@ -42,6 +42,10 @@ export const appleSiliconMenu = {
           label: 'Install a package manager',
           slug: 'install-package-manager-mac-mini',
         },
+        {
+          label: 'Create a GitHub/GitLab runner',
+          slug: 'create-runner',
+        },
         {
           label: 'Update the OS of a Mac mini',
           slug: 'update-os-mac-mini',
@@ -102,6 +106,10 @@ export const appleSiliconMenu = {
           label: 'Bare Metal shared responsibility model',
           slug: '../../elastic-metal/reference-content/shared-responsibility-model',
         },
+        {
+          label: 'Scaleway Dev OS for Apple silcion',
+          slug: 'scaleway-dev-os',
+        },
       ],
       label: 'Additional Content',
       slug: 'reference-content',
diff --git a/pages/apple-silicon/quickstart.mdx b/pages/apple-silicon/quickstart.mdx
@@ -28,25 +28,24 @@ Discover the Apple silicon interface on the Scaleway console.
 <Message type="important">
   - Due to license constraints, the minimum lease for Apple silicon is 24 hours. As a result, the earliest you can delete a Mac mini is 24 hours after the start of its lease.
 </Message>
-
-1. Click **Apple silicon** in the **Bare Metal** section of the side menu. The [Apple silicon creation page](https://console.scaleway.com/asaas/servers) displays.
+1. Click [Apple silicon](https://console.scaleway.com/asaas/servers) in the **Bare Metal** section of the side menu. The [Apple silicon splash page](https://console.scaleway.com/asaas/servers) displays.
 2. Click **Create Mac mini**. The Mac mini creation wizard displays.
 3. Complete the following steps in the wizard:
+    - Choose the **Standard** setup type for your Mac mini.
+    - Choose an **Availability Zone**, which is the geographical region where your Mac mini will be deployed. The available Mac mini configurations depend on the Availability Zone:
+      - Mac mini M4, M2 pro, and M2 are available in PARIS 1
+      - Mac mini M1 are available in PARIS 3
+    - Choose a macOS version. Note that if you choose a macOS other than the one installed by default, there will be a delay of about 1 hour before the Mac mini is made available.
+    - Optionally, configure the available public bandwidth for your server. This option may not be available for all offers.
+    - Choose whether to activate the **Private Networks 1 Gbps** feature. This lets you attach your Mac mini to one or more Scaleway Private Networks in a [VPC](/vpc/), enabling secure communication with other attached resources.
+    - Enter a **Name** for your Mac mini, or leave the randomly-generated name in place.
+    - Verify the **Estimated cost** for your Mac mini based on your chosen specifications.
     - Select the commitment plan for your Mac mini. Two options are available:
       - **No commitment:** You can terminate the subscription of your Mac mini at any time after the initial 24 hours, a mandatory period required by Apple's software license. [Learn more about Apple's software license requirements (Section 3.A)](https://www.apple.com/legal/sla/docs/macOSSequoia.pdf).
       - **Commitment:** You subscribe to a [commitment plan for Apple silicon](/apple-silicon/concepts/#commitment-plan) and benefit from a discounted monthly price based on your choice.
       <Message type="important">
         Currently, it is not possible to switch from a monthly commitment to hourly billing.
       </Message>
-    - Choose an **Availability Zone**, which is the geographical region where your Mac mini will be deployed. The available Mac mini configurations depend on the Availability Zone:
-      - Mac mini M4, M2 pro, and M2 are available in PARIS 1
-      - Mac mini M1 are available in PARIS 3
-    - Choose a macOS version.
-        <Message type="note">
-          If you choose a macOS other than the one installed by default, there will be a delay of about 1 hour before the Mac mini is made available.
-        </Message>
-    - Enter a **Name** for your Mac mini, or leave the randomly-generated name in place.
-    - Verify the **Estimated cost** for your Mac mini based on your chosen specifications.
 4. Tick the checkbox to agree to the Bare Metal specific conditions and the macOS License Agreement.
 5. Click **Create Mac mini** to finish. The installation of your Apple silicon is launched, and you are informed when it is ready.
 
diff --git a/pages/apple-silicon/reference-content/scaleway-dev-os.mdx b/pages/apple-silicon/reference-content/scaleway-dev-os.mdx
@@ -0,0 +1,42 @@
+---
+title: Scaleway Dev OS – Technical specifications
+description: Learn more about the technical specifications and characteristics of Scaleway’s Dev OS for Apple silicon.
+tags: apple-silicon connection mac-mini
+dates:
+  validation: 2025-12-09
+  posted: 2025-12-09
+---
+
+Dev OS is a developer-optimized operating system based on a recent version of macOS. It comes pre-configured with a complete set of development tools, runtimes, and dependencies aligned with the software stack used in GitHub Actions runner images.
+
+## Pre-installed software & developer tooling
+
+Dev OS comes pre-installed with a complete set of development tools and packages, including Apache, Xcode, web browsers, multiple programming language runtimes, SDKs, and more.  
+Choosing Dev OS eliminates the need for time-consuming manual installations. All installed components closely follow the configuration of the [GitHub Actions macOS-15 runner image](https://github.com/actions/runner-images/blob/main/images/macos/macos-15-Readme.md), ensuring consistency between environments.
+
+<Message type="important">
+  Although all software is pre-installed, **users are responsible for configuring tools according to their specific needs** (e.g., setting default Python versions, initializing Homebrew, configuring Git credentials, enabling Apache modules) and for **keeping this software up to date**.
+</Message>
+
+This ready-to-use toolkit typically saves developers **6–10+ hours** of initial setup time and helps prevent configuration drift across teams.
+
+## Disk space requirements
+
+Because Dev OS includes a large number of tools, runtimes, and dependencies, the system has a **base footprint of approximately 270 GB**.
+
+<Message type="note">
+  Keep in mind:
+  - Available user storage is significantly reduced compared to standard macOS installations.
+  - Dev OS is not compatible with Mac minis offering less than **512 GB** of storage.
+</Message>
+
+## Software licensing & user agreement
+
+By requesting and using a Dev OS machine, users acknowledge and agree to the **license terms of all pre-installed software**.
+
+This includes, but is not limited to:
+- Apple’s Xcode and macOS software licenses
+- Open-source licenses (MIT, GPL, Apache, etc.) for tools such as Homebrew, Node.js, and Python
+- Third-party SDKs and binaries distributed via their official sources
+
+Users **must comply** with all applicable licensing terms. Scaleway is not responsible for misuse or non-compliance with third-party software licenses.
