Building LXDock on Linux¶
LXDock should build very easily on Linux provided you have LXD available on your system.
Prerequisite: install LXD¶
You may want to skip this section if you already have a working installation of LXD on your system.
For Debian and Ubuntu, the following command will ensure that LXD is installed:
$ sudo apt-get install lxd
If you’re using an old version of Ubuntu you should first add the LXD’s apt repository and install
lxd package as follows:
$ sudo add-apt-repository -y ppa:ubuntu-lxc/lxd-stable $ sudo apt-get update $ sudo apt-get install lxd
For Fedora, LXD is available through an experimental COPR repository. Unfortunately SELinux is not yet supported, therefore make sure it is disabled or set to permissive. Then run:
# dnf copr enable ganto/lxd # dnf install lxd lxd-tools
You should now be able to configure your LXD installation using:
$ newgrp lxd # ensure your current user can use LXD $ sudo lxd init
lxd init command will ask you to choose the settings to apply to your LXD installation in
an interactive way (storage backend, network configuration, etc). But if you just want to go fast
you can try the following commands (note that this will only work for LXD 2.3+):
$ newgrp lxd $ sudo lxd init --auto $ lxc network create lxdbr0 ipv6.address=none ipv4.address=10.0.3.1/24 ipv4.nat=true $ lxc network attach-profile lxdbr0 default eth0
You can now check if your LXD installation is working using:
$ lxc launch ubuntu: first-machine && lxc exec first-machine bash
You can use
lxc stop first-machine to stop the previously created container.
You should now be able to install LXDock using:
$ pip3 install lxdock
pip3 installed on your system? Most distros have a specific package for it, it’s
only a matter of installing it. For example, on Debian and Ubuntu, it’s
Otherwise, Stackoverflow can help you.
Command line completion¶
LXDock can provide completion for commands, options and container names.
If you use Bash, you have to make sure that bash completion is installed (which should be the case
for most Linux installations). In order to get completion for LXDock, you should place the
contrib/completion/bash/lxdock file at
/etc/bash.completion.d/lxdock (or at any other place
where your distribution keeps completion files):
$ sudo curl -L https://raw.githubusercontent.com/lxdock/lxdock/$(lxdock --version | cut -d ' ' -f 2)/contrib/completion/bash/lxdock -o /etc/bash_completion.d/lxdock
Make sure to restart your shell before trying to use LXDock’s bash completion.
To add zsh completion for LXDock, place the
contrib/completion/zsh/_lxdock file at
/usr/share/zsh/vendor-completions/_lxdock (or another folder in
$ sudo curl -L https://raw.githubusercontent.com/lxdock/lxdock/$(lxdock --version | cut -d ' ' -f 2)/contrib/completion/zsh/_lxdock -o /usr/share/zsh/vendor-completions/_lxdock
Make sure to restart your shell before trying to use LXDock’s zsh completion.
Your first LXDock file¶
Create a file called
lxdock.yml) in your project directory and paste the
name: myproject containers: - name: test01 image: ubuntu/xenial - name: test02 image: archlinux
This LXDock file defines a project (
myproject) and two containers,
These containers will be constructed using respectively the
ubuntu/xenial and the
images (which will be pulled from an image server - https://images.linuxcontainers.org by default).
Now from your project directory, start up your containers using the following command:
$ lxdock up Bringing container "test01" up Bringing container "test02" up ==> test01: Unable to find container "test01" for directory "[PATH_TO_YOUR_PROJECT]" ==> test01: Creating new container "myproject-test01-11943450" from image ubuntu/xenial ==> test01: Starting container "test01"... ==> test01: No IP yet, waiting 10 seconds... ==> test01: Container "test01" is up! IP: [CONTAINER_IP] ==> test01: Doing bare bone setup on the machine... ==> test01: Adding ssh-rsa [SSH_KEY] to machine's authorized keys ==> test01: Provisioning container "test01"... ==> test02: Unable to find container "test02" for directory "[PATH_TO_YOUR_PROJECT]" ==> test02: Creating new container "myproject-test02-11943450" from image archlinux ==> test02: Starting container "test02"... ==> test02: No IP yet, waiting 10 seconds... ==> test02: Container "test02" is up! IP: [CONTAINER_IP] ==> test02: Doing bare bone setup on the machine... ==> test02: Adding ssh-rsa [SSH_KEY] to machine's authorized keys ==> test02: Provisioning container "test02"...
Congrats! You’re in!
If you’re having problems trying to run your container, try running them in privileged mode. Many older distributions have an init system that doesn’t work well with unprivileged containers (debian/jessie notably). Some host-side problems can also be worked around by running privileged containers.
If you received a permission denied error running the lxc network commands below:
$ lxc network create lxdbr0 ipv6.address=none ipv4.address=10.0.3.1/24 ipv4.nat=true $ lxc network attach-profile lxdbr0 default eth0
Run these commands below and then run the lxc network commands again. You should now be able to proceed with the remaining instructions.
$ sudo systemctl stop lxd.socket $ sudo systemctl start lxd.socket