toolshed/docs.coopcloud.tech
toolshed/docs.coopcloud.tech
3
1
Fork 21
Code Issues 4 Pull Requests 1 Packages Releases Activity

commens

Browse Source
This commit is contained in:
linnealovespie 2025-01-28 21:57:21 -08:00
parent 816c59d7e0
commit dc2c84c849
1 changed files with 12 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
docs/operators/tutorial.md
View File

@ -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 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 in and out again of your shell session to get the required permissions for
Docker. 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 # ssh into your server
@ -39,9 +39,18 @@ ssh <server-domain>
# docker install convenience script # docker install convenience script
wget -O- https://get.docker.com | bash 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 # add user to docker group
sudo usermod -aG docker $USER sudo usermod -aG docker $USER
# check that docker installed correctly
docker run hello-world
# exit and re-login to load the group # exit and re-login to load the group
exit exit
ssh <server-domain> ssh <server-domain>
@ -53,18 +62,7 @@ docker network create -d overlay proxy
# now you can exit and start using abra # now you can exit and start using abra
exit exit
``` ```
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.
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
```
??? question "Do you support multiple web proxies?" ??? question "Do you support multiple web proxies?"
@ -159,7 +157,7 @@ It is important to note that `<server-domain>` here is a publicy accessible doma
``` ```
And then: 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. You will now have a new `~/.abra/` folder on your local file system which stores all the configuration of your Co-op Cloud instance.