upctl server create
Create a server
Examples
upctl server create --title myapp --zone fi-hel1 --hostname myapp --password-delivery email
upctl server create --wait --title myapp --zone fi-hel1 --hostname myapp --password-delivery email
upctl server create --title "My Server" --zone fi-hel1 --hostname myapp --password-delivery email
upctl server create --zone fi-hel1 --hostname myapp --password-delivery email --plan 2xCPU-4GB
upctl server create --zone fi-hel1 --hostname myapp --password-delivery email --plan custom --cores 2 --memory 4096
upctl server create --zone fi-hel1 --hostname myapp --password-delivery email --os "Debian GNU/Linux 10 (Buster)" --server-group a4643646-8342-4324-4134-364138712378
upctl server create --zone fi-hel1 --hostname myapp --ssh-keys /path/to/publickey --network type=private,network=037a530b-533e-4cef-b6ad-6af8094bb2bc,ip-address=10.0.0.1
Options
Option | Description |
---|---|
--avoid-host |
Host to avoid when scheduling the server. Use this to make sure VMs do not reside on specific host. Refers to value from host attribute. Useful when building HA-environments.Default: 0 |
--boot-order |
The boot device order, disk / cdrom / network or comma separated combination. |
--cores |
Number of cores. Only allowed if plan option is set to "custom".Default: 0 |
--create-password |
Create an admin password. |
--enable-firewall |
Enable firewall. |
--enable-metadata |
Enable metadata service. |
--enable-remote-access |
Enable remote access. |
--host |
Schedule the server on a specific host. Refers to value from host attribute. Only available in private clouds.Default: 0 |
--hostname |
Server hostname. |
--label |
Labels to describe the server in key=value format, multiple can be declared.Usage: --label env=dev --label owner=operations Default: [] |
--memory |
Memory amount in MiB. Only allowed if plan option is set to "custom".Default: 0 |
--network |
A network interface for the server, multiple can be declared. Usage: --network family=IPv4,type=public --network type=private,network=037a530b-533e-4cef-b6ad-6af8094bb2bc,ip-address=10.0.0.1 Default: [] |
--os |
Server OS to use (will be the first storage device). The value should be title or UUID of an either public or private template. Set to empty to fully customise the storages. Default: Ubuntu Server 20.04 LTS (Focal Fossa) |
--os-storage-size |
OS storage size in GiB. This is only applicable if os is also set. Zero value makes the disk equal to the minimum size of the template.Default: 0 |
--os-storage-encrypt |
Encrypt the OS storage. This is only applicable if os is also set. |
--password-delivery |
Defines how password is delivered. Available: email, sms Default: none |
--plan |
Server plan name. See "server plans" command for valid plans. Set to "custom" and use cores and memory options for flexible plan.Default: 1xCPU-2GB |
--remote-access-password |
Defines the remote access password. |
--remote-access-type |
Set a remote access type. Available: vnc, spice |
--server-group |
UUID of a server group for the server. To remove the server from the group, see `servergroup modify |
--simple-backup |
Simple backup rule. Format (HHMM,{dailies,weeklies,monthlies}). Example: 2300,dailies |
--ssh-keys |
Add one or more SSH keys to the admin account. Accepted values are SSH public keys or filenames from where to read the keys. Default: [] |
--storage |
A storage connected to the server, multiple can be declared. Usage: --storage action=attach,storage=01000000-0000-4000-8000-000020010301,type=cdrom Default: [] |
--time-zone |
Time zone to set the RTC to. Default: UTC |
--title |
A short, informational description. |
--user-data |
Defines URL for a server setup script, or the script body itself. |
--username |
Admin account username. |
--video-model |
Video interface model of the server. Available: vga, cirrus Default: vga |
--wait |
Wait for server to be in started state before returning. |
--zone |
Zone where to create the server. Run upctl zone list to list all available zones. |
--help , -h |
help for create Default: false |
Global options
Option | Description |
---|---|
--client-timeout , -t |
Client timeout to use in API calls. Default: 0s |
--config |
Configuration file path. |
--debug |
Print out more verbose debug logs. Default: false |
--force-colours |
Force coloured output despite detected terminal support. |
--no-colours |
Disable coloured output despite detected terminal support. Colours can also be disabled by setting NO_COLOR environment variable. |
--output , -o |
Output format (supported: json, yaml and human) Default: human |
Related commands
Command | Description |
---|---|
upctl server | Manage servers |