Compare commits

..

5 Commits

Author SHA1 Message Date
mayel 807370bdd7 add sudo in front of group add
otherwise fails in some scenarios
2025-10-01 15:33:34 +00:00
decentral1se 59a6f5212b fix: latest debian has the right bats
continuous-integration/drone/push Build is passing
2025-09-29 09:19:10 +02:00
3wordchant 1c62eb78e1 Fix some tyops
continuous-integration/drone/push Build is passing
2025-09-22 17:22:23 +00:00
sixsmith f9463a6986 Update docs/federation/membership.md
continuous-integration/drone/push Build is passing
Change MIR voting member
2025-09-19 20:21:50 +00:00
decentral1se 907f9e38e7 docs: wording, link to handbook entry, formatting
continuous-integration/drone/push Build is passing
2025-09-16 14:58:31 +02:00
4 changed files with 17 additions and 23 deletions
+1 -10
View File
@@ -127,16 +127,7 @@ Then, before running tests, set `export BATS_LIB_PATH=~/.local/share/bats/`
##### Debian ##### Debian
``` ```
apt install bats-file bats-assert bats-support jq make git apt install bats bats-file bats-assert bats-support jq make git
```
Unfortunately, the latest `bats` version in Debian stable does not have the "filter tests by tags" feature, which is very handy for running a subset of the tests. For this, we need to install `bats` from source. It's easy.
```
apt purge -y bats
git clone https://github.com/bats-core/bats-core.git
cd bats-core
sudo ./install.sh /usr/local
``` ```
#### Setup Test Server #### Setup Test Server
+1 -1
View File
@@ -19,5 +19,5 @@ title: Membership
| `@decentral1se` | Waiver | - | `@decentral1se` | | `@decentral1se` | Waiver | - | `@decentral1se` |
| [ruangrupa](https://ruangrupa.id) | - | - | Henry `@babystepper:matrix.org` | | [ruangrupa](https://ruangrupa.id) | - | - | Henry `@babystepper:matrix.org` |
| [RTM](https://resisttechmonopolies.online) | ✅ | - | `@ammaratef45:matrix.org` + `@linnealovespie:matrix.org`| | [RTM](https://resisttechmonopolies.online) | ✅ | - | `@ammaratef45:matrix.org` + `@linnealovespie:matrix.org`|
| [MIR](https://mirnet.org/) | ✅ | - | `@brooke:pub.solar` | | [MIR](https://mirnet.org/) | ✅ | - | `@sixsmith:matrix.org` |
| [Red Abya Yala](https://abyayala.sutty.nl/) | - | - | `@fauno:sutty.nl` | | [Red Abya Yala](https://abyayala.sutty.nl/) | - | - | `@fauno:sutty.nl` |
+2 -2
View File
@@ -1,5 +1,5 @@
--- ---
title: "Resolution 032: RIM joins" title: "Resolution 032: RTM joins"
--- ---
- Topic: RTM joins Coopcloud - Topic: RTM joins Coopcloud
@@ -11,7 +11,7 @@ title: "Resolution 032: RIM joins"
Ammar's membership was approved in [Resolution 022](/federation/resolutions/passed/022). Ammar's membership was approved in [Resolution 022](/federation/resolutions/passed/022).
Since the establishment of RTM (Resist Rech Monopolies) collective in Seattle, Ammar has been unofficially representing the collective with coopcloud and vice versa. Since the establishment of RTM (Resist Tech Monopolies) collective in Seattle, Ammar has been unofficially representing the collective with coopcloud and vice versa.
### Details ### Details
+13 -10
View File
@@ -55,11 +55,12 @@ Abra can't deploy any applications in future steps unless it can run `docker` co
groups | grep docker groups | grep docker
# if the docker group doesn't already exist, add it manually # if the docker group doesn't already exist, add it manually
groupadd docker sudo groupadd docker
# add user to docker group # add user to docker group
sudo usermod -aG docker $USER sudo usermod -aG docker $USER
``` ```
After running `usermod`, you may need to (depending on your system) log out (`exit`) and back in again (`ssh <server-domain>`) to get the required permissions for Docker before proceeding. After running `usermod`, you may need to (depending on your system) log out (`exit`) and back in again (`ssh <server-domain>`) to get the required permissions for Docker before proceeding.
The [official Docker documentation](https://docs.docker.com/engine/install/linux-postinstall/) can help if you run into further issues. The [official Docker documentation](https://docs.docker.com/engine/install/linux-postinstall/) can help if you run into further issues.
@@ -85,8 +86,7 @@ Where `116.203.211.204` can be replaced with the IP address of your server.
### Install `abra` ### Install `abra`
Now we can install [`abra`](/abra) locally on your machine and hook it up to Now we can install [`abra`](/abra) locally on your machine and hook it up to your server. We support a script-based installation method ([script source](https://git.coopcloud.tech/toolshed/abra/src/branch/main/scripts/installer/installer)):
your server. We support a script-based installation method ([script source](https://git.coopcloud.tech/toolshed/abra/src/branch/main/scripts/installer/installer)):
```bash ```bash
curl https://install.abra.coopcloud.tech | bash curl https://install.abra.coopcloud.tech | bash
@@ -110,7 +110,7 @@ you have immediate access to `abra` on the current terminal.
export PATH=$PATH:$HOME/.local/bin export PATH=$PATH:$HOME/.local/bin
``` ```
If you run into issues during installation, [please report a ticket](https://git.coopcloud.tech/toolshed/organising/issues/new) :pray: If you run into issues during installation, [please report a ticket](https://git.coopcloud.tech/toolshed/abra/issues/new) :pray:
??? question "Can I install `abra` on my server?" ??? question "Can I install `abra` on my server?"
@@ -124,7 +124,7 @@ With autocomplete enabled, you can run a command like `abra app deploy myapp.exa
### Add your server ### Add your server
Now you can connect `abra` with your server. You must have a working SSH configuration for your server before you can proceed. That means you can run `ssh <server-domain>` on your command-line and everything Works :tm:. See the [`abra` SSH troubleshooting](/abra/trouble/#ssh-connection-issues) for a working SSH configuration example. Now you can connect `abra` with your server. You must have a working SSH configuration for your server before you can proceed. That means you can run `ssh <server-domain>` on your command-line and everything Works :tm:. See the [`abra` SSH troubleshooting](/abra/trouble/#ssh-connection-issues) for a working SSH configuration example or use `abra server add -h` for the help output.
??? warning "Beware of SSH dragons :dragon_face:" ??? warning "Beware of SSH dragons :dragon_face:"
@@ -146,13 +146,13 @@ It is important to note that `<server-domain>` here is a publicly accessible dom
??? warning "Can I use arbitrary server names?" ??? warning "Can I use arbitrary server names?"
Yes, this is possible. You need to pass `-D` to `server add` and ensure Yes, this is possible. You need to ensure that your `Host ...` entry in your SSH configuration includes the name. So, for example, in `~/.ssh/config`:
that your `Host ...` entry in your SSH configuration includes the name.
So, for example, in `~/.ssh/config`:
``` ```
Host example.com example Host example.com example
... ...
``` ```
And then: And then:
abra server add example abra server add example
@@ -167,8 +167,9 @@ abra server ls
??? question "How do I share my configs in `~/.abra`?" ??? question "How do I share my configs in `~/.abra`?"
It's possible and quite easy, for more see [this handbook It's possible and relatively easy, for more see [this handbook
entry](/operators/handbook/#understanding-app-and-server-configuration). entry](/operators/handbook/#understanding-app-and-server-configuration).
[Git](https://git-scm.com) skills are generally required.
### Web proxy setup ### Web proxy setup
@@ -182,7 +183,9 @@ You need to keep port `:80` and `:443` free on your server for web proxying to y
??? question "Do you support multiple web proxies?" ??? question "Do you support multiple web proxies?"
We do not know if it is feasible and convenient to set things up on an existing server with another web proxy which uses ports `:80` & `:443`. We'd happily receive reports and documentation on how to do this if you manage to set it up! Yes, this is possible. See [this handbook
entry](/operators/handbook/#proxying-apps-outside-of-co-op-cloud-with-traefik)
for more. Be warned, this is a relatively advanced topic.
**1. To get started, you'll need to create a new app:** **1. To get started, you'll need to create a new app:**