wieerwill/self-hosted-cookbook
1
0
Fork 0
mirror of https://github.com/tborychowski/self-hosted-cookbook.git synced 2025-01-22 19:38:30 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

update docker installation docs

Browse Source
This commit is contained in:
Dziad Borowy 2022-05-06 23:10:49 +01:00
parent 0439636c54
commit a2a8f2cb25
1 changed files with 13 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
docker/get-started.md
View File

@ -8,35 +8,25 @@ Installation instructions for Ubuntu Linux from: https://docs.docker.com/engine/
sudo apt-get remove docker docker-engine docker.io containerd runc
```
## Install Docker
## Install Docker & docker-compose-plugin (on Ubuntu)
```sh
sudo apt-get update
sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io
```
sudo apt update
sudo apt install ca-certificates curl gnupg lsb-release
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
## Install `docker-compose`
From: https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-compose-on-ubuntu-20-04
```sh
sudo apt-get remove docker-compose
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin
```
## Usage
Full docs are here: https://docs.docker.com/compose/reference/overview/
Generally the idea of `docker-compose` command is simple:
Generally the idea of `docker compose` command is simple:
1. First you create a folder for your service, e.g. `home-assistant`
2. Then you then create a `docker-compose.yml` file, which describes the service containers
3. You run `docker-compose up -d` and you're done!
3. You run `docker compose up -d` and you're done!
Here are the most frequently used commands:
@ -44,20 +34,20 @@ Here are the most frequently used commands:
#### Start a container
`-d` starts in a detached mode - which basically mean that it runs it in the background (so you can do other stuff, instead of looking at the logs).
```sh
docker-compose up -d
docker compose up -d
```
### Stop a container
There are 2 options:
```sh
docker-compose stop
docker-compose down
docker compose stop
docker compose down
```
First one (`stop`) onlu stops the containers, whereas the latter (`down`) does some more cleaning (removes the containers, networks, volumes), so I generally recommend `down` if you're tinkering.
### Update a container to use the latest published image
```sh
docker-compose pull && docker-compose up -d
docker compose pull && docker compose up -d
```
This pulls the latest images as defined in the local `docker-compose.yml` and recreates the containers.