Getting started with Lunni

Public beta

Lunni is in public beta. It is fairly stable, but there can be bugs.

Lunni is distributed as a Docker Swarm stack. To make setup easier, it comes with a simple installer, which only depends on Docker itself, and openssl CLI.

Install Docker Engine

Update the apt package index and install packages to allow apt to use a repository over HTTPS:
```
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg lsb-release
```

Add Docker's official GPG key:

# 'debian' or 'ubuntu'
DISTRO="$(lsb_release -is | tr [:upper:] [:lower:])"
sudo mkdir -p /etc/apt/keyrings
curl -fsSL "https://download.docker.com/linux/${DISTRO}/gpg" \
  | sudo gpg --dearmor -o '/etc/apt/keyrings/docker.gpg'

Use the following command to set up the repository:

echo "deb [arch=$(dpkg --print-architecture)" \
  'signed-by=/etc/apt/keyrings/docker.gpg]' \
  "https://download.docker.com/linux/${DISTRO}" \
  "$(lsb_release -cs) stable" \
  | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Update the apt package index again:
```
sudo apt-get update
```

Install Docker Engine, containerd, and Docker Compose.

sudo apt-get install \
  docker-ce docker-ce-cli containerd.io docker-compose-plugin

Verify that the Docker Engine installation is successful by running the hello-world image:
```
sudo docker run hello-world
```

Enable Swarm mode

Docker Swarm mode is Docker's built-in orchestrator. It deploys Docker stacks to production, in a distributed cluster. And it uses the same docker-compose.yml files you're likely using locally for development!

To set it up, run:

docker swarm init

Note

If you see an error like this:

Error response from daemon: could not choose an IP address to advertise since this system has
multiple addresses on interface eth0 (138.68.58.48 and 10.19.0.5) - specify one with
--advertise-addr

...select the public IP (e.g. 138.68.58.48 in this example), and run the command again with --advertise-addr:

docker swarm init --advertise-addr 138.68.58.48

Check that it worked:

docker node ls

Multiple nodes

You can add more nodes to the cluster, but it isn't a supported setup with Lunni right now. Lunni itself shouldn't break, but the application stacks you deploy need to be carefully designed to work with multiple nodes, especially if you use volumes.

In practice, starting with a single node will be easier, and when the time to grow comes, you can add more servers and figure out what changes are needed.

Point a domain to your server

Your domain can be second-level (acme-apps.cloud) or a subdomain (apps.acme.com) – Lunni doesn't really care about that.

Add the following records:

Type: A, from: [your-domain], to: your server's IP
Type: CNAME, from: *.[your-domain], to: [your-domain]

You can also add an AAAA record to support IPv6, but make sure it works properly first.

Install Lunni

Instal openssl:
```
sudo apt install openssl
```
Grab the installer script:
```
wget https://aed.ge/setup-lunni.sh
less setup-lunni.sh
```
Make sure you understand what it does (basically it asks a few questions to create a config, downloads the stack and deploys it).
Run it:
```
bash setup-lunni.sh
```
Fill in your domain name, email, and username and password for Traefik dashboard, then confirm setup.

After installation is finished, you'll see a link that will open the following page:

Welcome to Lunni

Come up with a username and password for your first admin user. It will have access to every project deployed on the server, so make sure the password is good. You can add more users later on.

Note

If you don't create your first admin user, Lunni will shut down after a few minutes to prevent others from accessing your server. To restart it, run:

docker service scale lunni_portainer={0,1}

Deploy something

That's it! You now have a Docker Swarm cluster, and a nice dashboard to manage it. Check out the next sections to find out what you can deploy there (spoiler: pretty much anything that comes with a docker-compose.yml file).