diff --git a/docs/operators/tutorial.md b/docs/operators/tutorial.md index 5715d94..7ec1641 100644 --- a/docs/operators/tutorial.md +++ b/docs/operators/tutorial.md @@ -30,7 +30,7 @@ You need to keep port `:80` and `:443` free on your server for web proxying to y When running `usermod ...`, you may need to (depending on your system) log in and out again of your shell session to get the required permissions for Docker. - Alternatively you can run `newgrp` to register the group chnage. + Alternatively you can run [`newgrp`](https://www.man7.org/linux/man-pages/man1/newgrp.1.html) to register the group chnage. ``` # ssh into your server @@ -39,9 +39,18 @@ ssh # docker install convenience script wget -O- https://get.docker.com | bash +# check if the docker group exists +groups | grep docker + +# if the docker group doesn't already exist, add it manually +sudo groupadd docker + # add user to docker group sudo usermod -aG docker $USER +# check that docker installed correctly +docker run hello-world + # exit and re-login to load the group exit ssh @@ -53,18 +62,7 @@ docker network create -d overlay proxy # now you can exit and start using abra exit ``` - -If you get an error saying the docker group doesn't exist, then docker didn't create the group during installation. You can create the group manually by running: - -``` - sudo groupadd docker -``` - -Abra can't deploy any applications in future steps if docker cannot run without sudo. To verify docker can run without sudo, run the docker test image: - -``` -docker run hello-world -``` +Abra can't deploy any applications in future steps if the docker group cannot run without sudo. If you install docker a different way, it may not create a docker group automatically. The [official Docker documentation](https://docs.docker.com/engine/install/linux-postinstall/) can help if you run into further issues. ??? question "Do you support multiple web proxies?" @@ -159,7 +157,7 @@ It is important to note that `` here is a publicy accessible doma ``` And then: - `abra server add -D example` + `abra server add example` You will now have a new `~/.abra/` folder on your local file system which stores all the configuration of your Co-op Cloud instance.