Apple silicon API
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
-
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>" -
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. As Apple silicon-as-a-service currently only offers one type, the possible value is M1-M
. -
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": "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"} -
Retrieve your Mac mini M1 server IP from the response.
-
Connect to your Mac mini M1 server using SSH:
ssh m1@<your_mac_mini_m1_ip>
- You have a Scaleway account
- You have created an API key and that the API key has sufficient IAM permissions to perform the actions described on this page
- You have installed
curl
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.
Servers
A server is a dedicated Apple Mac mini M1 server
GET/apple-silicon/v1alpha1/zones/{zone}/servers
POST/apple-silicon/v1alpha1/zones/{zone}/servers
GET/apple-silicon/v1alpha1/zones/{zone}/servers/{server_id}
PATCH/apple-silicon/v1alpha1/zones/{zone}/servers/{server_id}
DELETE/apple-silicon/v1alpha1/zones/{zone}/servers/{server_id}
POST/apple-silicon/v1alpha1/zones/{zone}/servers/{server_id}/reboot
POST/apple-silicon/v1alpha1/zones/{zone}/servers/{server_id}/reinstall
Server Types
A server type represents the technical specification of an available Mac mini server, such as its memory and disk size.
GET/apple-silicon/v1alpha1/zones/{zone}/server-type/{server_type}
GET/apple-silicon/v1alpha1/zones/{zone}/server-types
OS
Operating systems (OS) available for a given Mac mini server type. The default OS for all our Mac mini M1s is macOS Monterey 12 (Version 12.0.1). Other macOSes, e.g. Linux OS or Windows OS are not supported.
GET/apple-silicon/v1alpha1/zones/{zone}/os
GET/apple-silicon/v1alpha1/zones/{zone}/os/{os_id}