1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
|
(instances-create)=
# How to create instances
To create an instance, you can use either the `lxc init` or the `lxc launch` command.
The `lxc init` command only creates the instance, while the `lxc launch` command creates and starts it.
## Usage
Enter the following command to create a container:
lxc launch|init <image_server>:<image_name> <instance_name> [flags]
Image
: Images contain a basic operating system (for example, a Linux distribution) and some LXD-related information.
Images for various operating systems are available on the built-in remote image servers.
See {ref}`images` for more information.
Unless the image is available locally, you must specify the name of the image server and the name of the image (for example, `ubuntu:22.04` for the official 22.04 Ubuntu image).
Instance name
: Instance names must be unique within a LXD deployment (also within a cluster).
See {ref}`instance-properties` for additional requirements.
Flags
: See `lxc launch --help` or `lxc init --help` for a full list of flags.
The most common flags are:
- `--config` to specify a configuration option for the new instance
- `--device` to override {ref}`device options <devices>` for a device provided through a profile
- `--profile` to specify a {ref}`profile <profiles>` to use for the new instance
- `--network` or `--storage` to make the new instance use a specific network or storage pool
- `--target` to create the instance on a specific cluster member
- `--vm` to create a virtual machine instead of a container
## Pass a configuration file
Instead of specifying the instance configuration as flags, you can pass it to the command as a YAML file.
For example, to launch a container with the configuration from `config.yaml`, enter the following command:
lxc launch images:ubuntu/22.04 ubuntu-config < config.yaml
```{tip}
Check the contents of an existing instance configuration (`lxc config show <instance_name> -e`) to see the required syntax of the YAML file.
```
## Examples
The following examples use `lxc launch`, but you can use `lxc init` in the same way.
### Launch a container
To launch a container with an Ubuntu 22.04 image from the `images` server using the instance name `ubuntu-container`, enter the following command:
lxc launch images:ubuntu/22.04 ubuntu-container
### Launch a virtual machine
To launch a virtual machine with an Ubuntu 22.04 image from the `images` server using the instance name `ubuntu-vm`, enter the following command:
lxc launch images:ubuntu/22.04 ubuntu-vm --vm
Or with a bigger disk:
lxc launch images:ubuntu/22.04 ubuntu-vm-big --vm --device root,size=30GiB
### Launch a container with specific configuration options
To launch a container and limit its resources to one vCPU and 192 MiB of RAM, enter the following command:
lxc launch images:ubuntu/22.04 ubuntu-limited --config limits.cpu=1 --config limits.memory=192MiB
### Launch a VM on a specific cluster member
To launch a virtual machine on the cluster member `server2`, enter the following command:
lxc launch images:ubuntu/22.04 ubuntu-container --vm --target server2
### Launch a container with a specific instance type
LXD supports simple instance types for clouds.
Those are represented as a string that can be passed at instance creation time.
The syntax allows the three following forms:
- `<instance type>`
- `<cloud>:<instance type>`
- `c<CPU>-m<RAM in GiB>`
For example, the following three instance types are equivalent:
- `t2.micro`
- `aws:t2.micro`
- `c1-m1`
To launch a container with this instance type, enter the following command:
lxc launch images:ubuntu/22.04 my-instance --type t2.micro
The list of supported clouds and instance types can be found at [`https://github.com/dustinkirkland/instance-type`](https://github.com/dustinkirkland/instance-type).
|
