Install docker

# Docker installation

This is a simple guide on how to install docker on a raspberry pi

> [!CAUTION]
> Make sure you have sudo access to the PI!!

To install docker itself i recommed using the 
[documentation from docker](https://docs.docker.com/engine/install/) the documentation has a convenience script seen bellow

```sh
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh ./get-docker.sh
```

Then you need to allow your user to use docker commands without sudo


```sh
sudo usermod -aG docker $USER
```

And then instaid of rebooting we reload the changes

```sh
newgrp docker
```

# Example containers and configuration

In my opinion the best way to do docker compose files is a structure like this

/docker/[Projectname]/compose.yml
 
so we create the docker directory, allow the user to read and write in the directory and also creating a symbolic link to the directory in the home directory 

```sh
sudo mkdir /docker
sudo chown $USER:$USER /docker
sudo ln -s /docker
```

## Breakdown of the commands
- `sudo mkdir /docker`: Creates a new directory called `docker` in the root directory. (Root directory is `/`)
- `sudo chown $USER:$USER /docker`: Changes the ownership of the `/docker` directory to the current user, allowing read and write access.
- `sudo ln -s /docker`: Creates a symbolic link to the `/docker` directory in the current user's home directory, making it easier to access.
- `docker compose up -d`: Starts the Docker containers defined in the `compose.yml` file in detached mode, allowing them to run in the background. The `-d` flag stands for "detached mode".
- `docker compose down`: Stops and removes the containers defined in the `compose.yml` file, cleaning up resources.

## Creating a pihole installation

> [!INFORMATION]
> This is just a exerpt from the [pihole documentation](https://docs.pi-hole.net/docker/)

folowing the structure we make a new directory in /docker

```sh
mkdir /docker/pihole
cd /docker/pihole
nano compose.yml
```

then copy the pihole example compose file from below
```text
# More info at https://github.com/pi-hole/docker-pi-hole/ and https://docs.pi-hole.net/
services:
  pihole:
    container_name: pihole
    image: pihole/pihole:latest
    ports:
      # DNS ports
      - "53:53/tcp"
      - "53:53/udp"
      # WEB GUI
      - "80:80/tcp"
      - "443:443/tcp"
      # DHCP
      - "67:67/udp"
    environment:
      TZ: 'Europe/Oslo'
      FTLCONF_webserver_api_password: '(change me)'
      FTLCONF_dns_listeningMode: 'all'
    volumes:
      - './etc-pihole:/etc/pihole'
    cap_add:
      - NET_ADMIN
      - SYS_TIME
      - SYS_NICE
    restart: unless-stopped
```

Save and exit and now we are ready to start pihole with this will create a configuration directory

```sh
docker compose up -d
```

## Creating a Minecraft Server

> [!INFORMATION]
> This is just a exerpt from the [itzg docker minecraft server documentation](https://docker-minecraft-server.readthedocs.io/en/latest/)

folowing the structure we make a new directory in /docker

```sh
mkdir /docker/minecraft
cd /docker/minecraft
nano compose.yml
```

then copy the pihole example compose file from below
```text
services:
  mc:
    image: itzg/minecraft-server
    tty: true
    stdin_open: true
    ports:
      - "25565:25565"
    environment:
      EULA: "TRUE"
    volumes:
      # attach the relative directory 'data' to the container's /data path
      - ./data:/data
``` 

Save and exit and now we are ready to start pihole with this will create a configuration directory

```sh
docker compose up -d
```