XUtils

Scaleway-cli

Manage BareMetal Servers from Command Line (as easily as with Docker).


Homebrew

Install the latest stable release on macOS/Linux using Homebrew:

brew install scw

Arch Linux

Install the latest stable release on Arch Linux from official repositories. For instance with pacman:

pacman -S scaleway-cli

Chocolatey

Install the latest stable release on Windows using Chocolatey (Package):

choco install scaleway-cli

Manually

Released Binaries

We provide static-compiled binaries for darwin (macOS), GNU/Linux, and Windows platforms. You just have to download the binary compatible with your platform to a directory available in your PATH:

Linux

curl -s https://raw.githubusercontent.com/scaleway/scaleway-cli/master/scripts/get.sh | sh

Windows

You can download the last release here: https://github.com/scaleway/scaleway-cli/releases
This official guide explains how to add tools to your PATH.

Docker Image

You can use the CLI as you would run any Docker image:

docker run -i --rm scaleway/cli:latest

See more in-depth information about running the CLI in Docker here

Getting Started

Basic commands

# Create an instance server
scw instance server create type=DEV1-S image=ubuntu_focal zone=fr-par-1 tags.0="scw-cli"

# List your servers
scw instance server list

# Create a Kubernetes cluster named foo with cilium as CNI, in version 1.17.4 and with a pool named default composed of 3 DEV1-M and with 2 tags
scw k8s cluster create name=foo version=1.17.4 pools.0.size=3 pools.0.node-type=DEV1-M pools.0.name=default tags.0=tag1 tags.1=tag2

Environment

You can configure your config or enable functionalities with environment variables.

Variables to override config are describe in config documentation. To enable beta features, you can set SCW_ENABLE_BETA=1 in your environment.

Reference documentation

Namespace Description Documentation
account User related data CLI / API
applesilicon Apple silicon API CLI / API
autocomplete Autocomplete related commands CLI
baremetal Baremetal API CLI / API
billing Billing API CLI / API
cockpit Cockpit API CLI / API
config Config file management CLI
container Serverless Container API CLI / API
documentdb DocumentDB API CLI
dns DNS API CLI / API
feedback Send feedback to the Scaleway CLI Team! CLI
flexibleip Flexible IP API CLI / API
function Serverless Function API CLI / API
iam IAM API CLI / API
info Get info about current settings CLI
init Initialize the config CLI
instance Instance API CLI / API
iot IoT API CLI / API
ipam IPAM API CLI / API
k8s Kapsule API CLI / API
lb Load Balancer API CLI / API
marketplace Marketplace API CLI
mnq Messaging and Queueing API CLI / API
object Object-storage utils CLI / API
rdb Database RDB API CLI / API
redis Redis API CLI / API
registry Container registry API CLI / API
secret Secret manager API CLI / API
shell Start Shell mode CLI
tem Transactional Email API CLI / API
vpc-gw VPC Gateway API CLI / API
vpc VPC API CLI / API

Build it yourself

Build with Docker

You can build the scw CLI with Docker. If you have Docker installed, you can run:

docker build -t scaleway/cli .

Once built, you can then use the CLI as you would run any image:

docker run -i --rm scaleway/cli

See more in-depth information about running the CLI in Docker here

Reach Us

We love feedback. Don’t hesitate to open a Github issue or feel free to reach us on Scaleway Slack community, we are waiting for you on #opensource.


Articles

  • coming soon...