You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+26-8Lines changed: 26 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -31,19 +31,37 @@ your account to the `libvirtd` group.
31
31
32
32
33
33
# Capabilities
34
-
***boot2docker.iso** based images
35
-
***Dual Network**
36
-
***eth1** - A host private network called **docker-machines** is automatically created to ensure we always have connectivity to the VMs. The `docker-machine ip` command will always return this IP address which is only accessible from your local system.
37
-
***eth0** - You can specify any libvirt named network. If you don't specify one, the "default" named network will be used.
34
+
35
+
## Images
36
+
By default `docker-machine-kvm` uses a [boot2docker.iso](https://github.com/boot2docker/boot2docker) as guest os for the kvm hypervisior. It's also possible to use every guest os image that is derived from [boot2docker.iso](https://github.com/boot2docker/boot2docker) as well.
37
+
For using another image use the `--kvm-boot2docker-url` parameter.
38
+
39
+
Community Members did some tests and it works with [rancher/os](https://github.com/rancher/os) as guest os too.
40
+
41
+
## Dual Network
42
+
43
+
***eth1** - A host private network called **docker-machines** is automatically created to ensure we always have connectivity to the VMs. The `docker-machine ip` command will always return this IP address which is only accessible from your local system.
44
+
***eth0** - You can specify any libvirt named network. If you don't specify one, the "default" named network will be used.
38
45
* If you have exotic networking topolgies (openvswitch, etc.), you can use `virsh edit mymachinename` after creation, modify the first network definition by hand, then reboot the VM for the changes to take effect.
39
46
* Typically this would be your "public" network accessible from external systems
40
47
* To retrieve the IP address of this network, you can run a command like the following:
41
48
```bash
42
49
docker-machine ssh mymachinename "ip -one -4 addr show dev eth0|cut -f7 -d' '"
43
50
```
44
51
45
-
***Other Tunables**
46
-
* Virtual CPU count via --kvm-cpu-count
47
-
* Disk size via --kvm-disk-size
48
-
* RAM via --kvm-memory
52
+
## Driver Parameters
53
+
54
+
Here are all currently driver parameters listed that you can use.
55
+
56
+
| Parameter | Description|
57
+
| ------------- | ------------- |
58
+
|**--kvm-cpu-count**| Sets the used CPU Cores for the KVM Machine. Defaults to `1` . |
59
+
|**--kvm-disk-size**| Sets the kvm machine Disk size in MB. Defaults to `20000` . |
60
+
|**--kvm-memory**| Sets the Memory of the kvm machine in MB. Defaults to `1024`. |
61
+
|**--kvm-network**| Sets the Network of the kvm machinee which it should connect to. Defaults to `default`. |
62
+
|**--kvm-boot2docker-url**| Sets the url from which host the image is loaded. By default it's not set. |
63
+
|**--kvm-cache-mode**| Sets the caching mode of the kvm machine. Defaults to `default`. |
64
+
|**--kvm-io-mode-url**| Sets the disk io mode of the kvm machine. Defaults to `threads`. |
0 commit comments