Apple silicon API

Close Introduction

Scaleway Apple silicon is built using Apple's fifth generation Mac mini hardware. Powered by Apple’s M1 silicon and equipped with a 256 GB SSD and 8 GB of RAM, it's designed for towering performance and revolutionary power efficiency. The M1 chip has an Apple Silicon processor: a powerful 8-core CPU running at up to 3.2 GHz.

This M1 processor is designed for developers to create and sign applications for a wide range of Apple devices: from iPhones and iPads to Mac computers and beyond. With its advanced neural engine, Mac mini M1 can process machine learning tasks up to 15 times faster than traditional computers.

A dedicated Mac mini M1 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. Since there is only one Availability Zone for Apple silicon, the possible value for zone is fr-par-3.

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

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"
   }Copy

   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. As Apple silicon-as-a-service currently only offers one type, the possible value is 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"
     }'Copy

   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": "https://192.168.1.93",
     "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"
   }Copy

4. Retrieve your Mac mini M1 server IP from the response.

5. Connect to your Mac mini M1 server using SSH:

   ssh m1@<your_mac_mini_m1_ip>Copy

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 M1 can be deployed in the following Availability Zone:

• Paris fr-par-3

Technical limitations

The following technical limiations apply when using Apple silicon:

• Apple silicon-as-a-Service comes with a minimum allocation period of 24 hours.
• There is a maximum of one Mac mini M1 allowed per Organization per Availability Zone. 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.

Open Servers

Open Server Types

Open OS