# Setting up Docker (and Docker Desktop) on Ubuntu
## Sources
  * https://docs.docker.com/desktop/setup/install/linux/ubuntu/

## Prerequisites
  - verify you have a GNOME-based desktop environment (Ubuntu Desktop is GNOME-based)
    - if not install gnome-terminal - `sudo apt install gnome-terminal`
  - verify you have KVM virtualization support - `lsmod | grep kvm`
    - if `kvm` and `kvm_<arch>` is not listed check [here](https://docs.docker.com/desktop/setup/install/linux/#kvm-virtualization-support)
    - ensure your user is part of the kvm group - `sudo usermod -aG kvm $USER`

## Install Steps
  - ensure apt-get is up to date - `sudo apt-get update`
  - download the proper install for docker-desktop
    - for Ubuntu this is a `.deb` file
    - https://download.docker.com/linux/ubuntu/dists/
      - to make sense of the release names see https://wiki.ubuntu.com/Releases
      - (24.04.2 LTS = "Noble Numbat" = https://download.docker.com/linux/ubuntu/dists/noble/pool/stable/)
      - find the right directory for your CPU architecture via `dpkg --print-architecture`
        - https://download.docker.com/linux/ubuntu/dists/noble/pool/stable/amd64/
      - download the latest version of all install files
        * containerd.io_<version>_<arch>.deb
        * docker-buildx-plugin_<version>_<arch>.deb
        * docker-ce-cli_<version>_<arch>.deb
        * docker-ce-rootless-extras...?
          * not certain about this one; it's listed in the download site but not the docs
        * docker-ce_<version>_<arch>.deb
        * docker-compose-plugin_<version>_<arch>.deb
      - install the packages
        - `sudo dpkg -i ./containerd.io_*.deb ./docker-ce_*.deb ./docker-ce-cli_*.deb ./docker-buildx-plugin_*.deb ./docker-compose-plugin_*.deb`

## Startup and Verify Docker
  - `sudo service docker start`
  - verify with a hello-world container
    - `sudo docker run hello-world`
  - configure to start on boot
    - `sudo systemctl enable docker.service containerd.service`

## Configure Docker Logging
  - `vi /etc/docker/daemon.json`
    - add logging config per https://docs.docker.com/engine/logging/drivers/json-file/#usage

## Install Docker Desktop
  * get latest deb file (rather large - 356MB)
    * `curl -O https://desktop.docker.com/linux/main/amd64/docker-desktop-amd64.deb`
  * `sudo apt-get install ./docker-desktop-amd64.deb`
    * ignore error msg at end (`N: Download is performed unsandboxed as root as file '.../docker-desktop-amd64.deb' couldn't be accessed by user '_apt'. - pkgAcquire::Run (13: Permission denied)`
  * there should now be a "Docker Desktop" icon in the Apps section