docs(aps): init docs runners

bene2k1 · bene2k1 · commit 8616d570bf68 · 2025-12-04T17:25:23.000+01:00
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/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,78 @@
+---
+title: How to create a GitHub / GitLab runner on Apple silcion
+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-04
+  posted: 2025-12-04
+---
+import Requirements from '@macros/iam/requirements.mdx'
+
+
+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
+    - Mac mini M1 are available in PARIS 3
+    - Choose a [Dev OS](/apple-silicon/reference-content/scaleway-dev-os/) version.
+    - 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.
+        </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.
+
+## 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.
+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.
+
+## 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,54 @@
+---
+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-04
+  posted: 2025-12-04
+---
+
+Dev OS is a developer-optimized operating system based on a recent version of macOS (Dev OS 15 is based on macOS Sequoia). It comes pre-configured with a curated 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 ships with a comprehensive 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 local and CI 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>
+
+## Kernel extension support & system integrity
+
+Dev OS is configured to support specific **whitelisted kernel extensions (KEXTs)** to enable advanced development and file system use cases.
+
+- **MacFUSE support is enabled**, allowing users to mount custom file systems (e.g., cloud storage, encrypted volumes, or distributed file systems).
+- Unlike standard macOS deployments, **no reboot into Recovery Mode is required** to approve or load these extensions.
+- Apple’s System Integrity Protection (SIP) remains enabled; approved KEXTs are pre-authorized through configuration profiles.
+
+<Message type="note">
+  Full documentation on installing and using MacFUSE will be published soon. This functionality is particularly useful for developers working with remote file systems or custom storage backends.
+</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.
