Apple silicon API

Introduction

Step into the future of computing with Apple Silicon, our Mac mini M1, M2, and M2-Pro dedicated machines. Enjoy unparalleled speed and performance to handle all your computing needs with the latest generations of Mac mini hardware.

A dedicated Mac mini thus allows you to enjoy dazzling performance and speed, enabling you to explore, learn, and build like never before.

Concepts

Refer to our dedicated concepts page to find definitions of the different terms referring to Apple silicon.

Quickstart

1. Configure your environment variables.

   Note

   This is an optional step that seeks to simplify your usage of the APIs. There are two Availability Zones for Apple silicon, the possible values for zone are fr-par-1 and fr-par-3.

   export SCW_SECRET_KEY="<API secret key>"
   export SCW_DEFAULT_ZONE="<Scaleway Availability Zone>"
   

2. Edit the POST request payload that we will use in the next step to create an Apple silicon server.

   Modify the values in the example according to your needs, using the information in the table to help.

   {
     "name": "My_AS_Server",
     "project_id": "7281793f-8474-727d-7688-72893f747g7e",
     "type": "M1-M"
   }
   

   Parameter	Description
   project_id	ID of the Project you want to create your server in. Your project name can only contain alphanumeric characters, spaces, dots and dashes. To find your Project ID, you can consult the Scaleway console
   name	Create a server with this given name.
   type	Create a server of the given type. The possible values are M2-L, M2-M and M1-M.

3. Run the following command to create a server. Make sure you include the payload you edited in the previous step.

   curl -X POST \
     -H "X-Auth-Token: $SECRET_KEY" \
     -H "Content-Type: application/json" \
     "https://api.scaleway.com/apple-silicon/v1alpha1/zones/$ZONE/servers" \
     -d '{
       "name": "My_Mac_Mini_M1",
       "project_id": "7281793f-8474-727d-7688-72893f747g7e",
       "type": "M1-M"
     }'
   

   You should get an output similar to the following one, providing details about your Apple silicon server.

   Note

   This is a response example, the UUIDs and IP address displayed are not real.

   {
     "id": "d6877c16-77af-40a2-8b13-514cee3e73f5",
     "type": "M1-M",
     "name": "My_Mac_Mini_M1",
     "project_id": "7281793f-8474-727d-7688-72893f747g7e",
     "organization_id": "b12d5c3g-c612-5674-c1e9-92627f36c5b9",
     "ip": "1.2.3.4",
     "vnc_url": "vnc://m1:password@192.168.1.93:5900",
     "ssh_username": "m1",
     "sudo_password": "password",
     "status": "unknown_status",
     "created_at": "2022-03-22T12:34:56.123456Z",
     "updated_at": "2022-03-22T12:34:56.123456Z",
     "deletable_at": "2022-03-22T12:34:56.123456Z",
     "zone": "fr-par-3"
   }
   

4. Retrieve your Mac mini IP from the response.

5. Connect to your Mac mini using SSH:

   ssh m1@<your_mac_mini_ip>
   

Technical information

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.

Availability Zones

Mac mini can be deployed in the following Availability Zones:

• Paris fr-par-1
• Paris fr-par-3

Technical limitations

The following technical limitations apply when using Apple silicon:

• Apple silicon-as-a-Service comes with a minimum allocation period of 24 hours.
• The maximum number of Mac mini allowed per Organization depends on the offer selected. Learn more about account quotas with our dedicated documentation.

Going further

For more help using Scaleway Apple silicon, check out the following resources:

• Our main documentation
• Our Slack Community
• Our support ticketing system.