28 Commits

Author SHA1 Message Date
f61538ff10 fix: move file
All checks were successful
continuous-integration/drone/push Build is passing
2026-01-19 22:23:32 +01:00
5717e15966 fix: publish, new date
All checks were successful
continuous-integration/drone/push Build is passing
2026-01-19 22:21:56 +01:00
3bccc629b2 fix: membership fee 2026-01-19 22:21:00 +01:00
b433dbd666 fix: formatting
All checks were successful
continuous-integration/drone/push Build is passing
2026-01-16 19:38:28 +01:00
dd9153bf93 fix: wording
All checks were successful
continuous-integration/drone/push Build is passing
2026-01-16 19:34:08 +01:00
125fbe3545 fix: reworking R036
All checks were successful
continuous-integration/drone/push Build is passing
2026-01-16 19:30:47 +01:00
06552cc793 feat: new drafts
All checks were successful
continuous-integration/drone/push Build is passing
2026-01-16 19:02:24 +01:00
e43dcd1238 fix: formatting
All checks were successful
continuous-integration/drone/push Build is passing
2026-01-15 22:22:18 +01:00
1b7850a914 docs: Where can maintainers find support
All checks were successful
continuous-integration/drone/push Build is passing
Add a chapter to "How to Become a Recipe Maintainer",
 so that new maintainers know where to turn for help.

Goal: lower the barrier to becoming a maintainer
 for people not (yet) integrated into the community.
2026-01-15 20:21:27 +01:00
e725938bf7 fix: note about repo itself
All checks were successful
continuous-integration/drone/push Build is passing
2026-01-15 10:46:46 +01:00
7d5ec230b8 refactor: wording, formatting & links
All checks were successful
continuous-integration/drone/push Build is passing
2026-01-01 20:31:58 +01:00
05b8c6ac26 wip: docs: moar maintainer updates
All checks were successful
continuous-integration/drone/push Build is passing
2025-12-29 23:05:44 +01:00
f268168cb9 wip: feat: better maintainer docs
All checks were successful
continuous-integration/drone/push Build is passing
2025-12-29 22:08:58 +01:00
b7c84ab550 fix: name
All checks were successful
continuous-integration/drone/push Build is passing
2025-12-28 10:33:17 +01:00
ffb0dd6fe9 fix: put in menu
All checks were successful
continuous-integration/drone/push Build is passing
2025-12-28 10:31:27 +01:00
93dfea0172 feat: 39c3 docs
All checks were successful
continuous-integration/drone/push Build is passing
2025-12-28 10:25:03 +01:00
3c9bae3a7f sidenote to clarify how local abra works
All checks were successful
continuous-integration/drone/push Build is passing
2025-12-15 07:53:43 +01:00
c792f87520 Convenience script call updated
- use curl for consistency
- copied the warning from the install script (i.e., do not use for prod
  envs)
2025-12-15 07:50:12 +01:00
51b1b6b384 add note about dynDNS and CNAME 2025-12-14 23:17:47 +01:00
b144b5332b fix line wrap inside HREF
Using this method seems to breakt the question box
2025-12-14 23:16:53 +01:00
3wc
7d896ac964 fix: List formatting under "How do I specify the charset for a specific secret generation"
All checks were successful
continuous-integration/drone/push Build is passing
2025-12-10 20:23:19 -05:00
val
26a668e223 added paragraph on overriding the compose.yml
All checks were successful
continuous-integration/drone/push Build is passing
2025-11-21 17:42:22 +00:00
bbf1b7988f fix: quotes
All checks were successful
continuous-integration/drone/push Build is passing
2025-11-20 20:59:04 +01:00
3wc
08d02a6d08 Mark resolution 034 as passed
All checks were successful
continuous-integration/drone/push Build is passing
2025-11-12 08:54:45 -05:00
6470aec9db docs: more release docs
All checks were successful
continuous-integration/drone/push Build is passing
2025-11-09 11:45:18 +01:00
06fd956f62 docs: more release docs
All checks were successful
continuous-integration/drone/push Build is passing
2025-11-09 11:40:12 +01:00
5a0da5d60f chore: v0.12 upgrade notes
All checks were successful
continuous-integration/drone/push Build is passing
2025-11-09 11:37:33 +01:00
f0120151d8 docs: improve STACK_NAME explanation
All checks were successful
continuous-integration/drone/push Build is passing
2025-11-09 09:24:00 +01:00
15 changed files with 311 additions and 20 deletions

View File

@ -359,8 +359,35 @@ For developers, while using this `-beta` format, the `y` part is the "major" ver
- Push the new tag (e.g. `git push && git push --tags`)
- Wait until the build finishes on [build.coopcloud.tech](https://build.coopcloud.tech/toolshed/abra)
- Deploy the new installer script (e.g. `cd ./scripts/installer && make`)
- Clean up the changelog on the releases page so it includes most relevant
changes. See below for the announcement text that needs to be inserted above
the generated changelog. You can use something like `git shortlog -e -s -n
0.11.0-beta..HEAD` to get the list of authors.
- Make sure there is a migration guide written in the docs (if necessary)
- Check the release worked, (e.g. `abra upgrade; abra -v`)
- Share the announcement:
- Share the announcement on our General chat and fedi account:
#### Release notes text
```
## Changelog
> 🎺🎺🎺 [`0.XX.x-beta` 👉 `0.XX.0-beta` **migration guide**](XXX) 🎺🎺🎺
`abra` update `HOWTO` documentation is [here](https://docs.coopcloud.tech/abra/upgrade/).
The project with all changes and discussions is [here](XXX).
A huge thanks to all our `abra` hackers for this release 💖
```
...
```
$CHANGELOG
```
#### General announcement text
```
📢📢📢 abra v0.XX is finally here 📢📢📢
@ -379,6 +406,8 @@ https://docs.coopcloud.tech/abra/upgrade/#XXx-beta-0XXx-beta
A huge thanks to everyone who helped get this release done ❤️‍🔥
Happy Hacking 🫂
-- $handle
```
## Fork maintenance

View File

@ -53,6 +53,12 @@ And test things work.
> General release notes are [here](https://git.coopcloud.tech/toolshed/abra/releases/)
### `0.11.x-beta` -> `0.12.x-beta`
* `kadabra` has been archived and is no longer published alongside `abra`
releases. See [`#699`](https://git.coopcloud.tech/toolshed/abra/issues/699)
for more.
### `0.10.x-beta` -> `0.11.x-beta`
* Timeouts are no longer used unless specifically set in the app `.env` file,

View File

@ -0,0 +1,45 @@
---
title: 2025-12-28
---
## Coop-Cloud Meetup @ 39C3
> Warning: this is no real protocol, since we did not really decide someone to
> write down something (and what), but it was my try to summarize the
> conclusive parts. For all attendees, please correct and extend on what i
> wrote here, if something is missing or wrong :)
### Talk about Coop-Cloud
Simon and d1 are looking into the old state and maybe update it.
### Alakazam workshop
Tomorrow 16:15 at the coop-cloud table.
### Daily things with coop-cloud (what is nice, what not)
* Generally good experience
* SSO stuff is cumbersome
* Keeping an eye on recipe changes is a bit hard
* Onboarding for new users could be easyer
* Catalog has structural problems
* All are using several workarounds
* Upgrading a recipe is cumbersome (there is a proposal to make that better, just has to be implemented)
### More cooperation in general/ reflect on kiteflying / talk about finances:
* Me try to do it once a month with more static topics
* The radmin role would maybe help to fix to get people payed for stuff through that
* Draft from p4u1 and d1
* Maybe a proposal gets made by kawaiipunk to rise the wage for internal tasks (discussions will follow to refine that idea)
* We want to implement the maintainers proposal to more recipes
* We should implement default guidelines for cooperation/contribution for the recipes, which can be "overwritten" by each reipe maintainers
* We want to experiment with automated testing, for recipes, here it would be great to have some kind of a defined list of what should be tested
* Maybe we could implement a language server for abra
* Idea: Workaround sharing session or blog write ups about the workarounds used
* Idea: move away from the env file in the future via defining a standard over alakazam without breaking the env (like upstream alakazam)
### Political Statement in the Documentation
d1 puts survey answers to a text and then we work together and decide it in a kiteflying.

View File

@ -0,0 +1,33 @@
---
title: "Resolution 035: Budget 016: Sutty Website Proposal"
---
- Topic: Budget 016: Sutty Website Proposal
- Date: 2026-01-16
- Deadline: 2026-01-30
- Size: Large
## Summary
Budget 016 proposes to:
1. Compensate Sutty and Co-op Cloud community members `@edu` & `@eli` 250 USD according to their own proposed compensation.
1. Compensate `@diatom` for up to 10 hours to participate in the generative process as Co-op Cloud community delegate.
Please see [the full proposal text](https://vvvvvvaria.org/~decentral1se/cc/CoopCloud-2025WebsiteProposal-Sutty.pdf) for more details. See `Capítulo 3 > Resources estimations` for the section regarding financial estimations. The Co-op Cloud community and federation are to be consulted during this process for decision making around choosing a new website proposal. `@diatom` agrees to be a bridge between the work of `@edu`/`@eli` and the Co-op Cloud community.
## Details (Budget 016)
This resolution follows the Good Work of `@sef`/`@edu`/`@eli` in carrying out the Co-op Cloud Community Website Survey. The idea is that `@edu` and `@eli` (with the blessing of `@sef`) will now bring forward a concrete proposal for the new Co-op Cloud website based on their proposed generative process. Please see [the full proposal text](https://vvvvvvaria.org/~decentral1se/cc/CoopCloud-2025WebsiteProposal-Sutty.pdf) for all details.
#### Budget
`@edu`/`@eli`/`@diatom` will carry out this work.
Please join `#coop-cloud-new-website:autonomic.zone` to participate in this process. All community members are welcome.
The budget total is:
* 250 USD (216 EUR)
* 10 hrs * 20 EUR = 200 EUR
* **Total**: 416 EUR

View File

@ -0,0 +1,28 @@
---
title: "Resolution 036: Democratic Tech Fund joins the Co-op Cloud Federation"
---
- Topic: Resolution 036: Democratic Tech Fund joins the Co-op Cloud Federation
- Date: 2026-01-19
- Deadline: 2026-02-02
- Size: Large
## Summary
The Democratic Tech Fund (DTF) is a Project-In-The-Making which has close affinity with Co-op Cloud in culture and stated goals. `@mikemh` and `@wtebbens` are active members of the community and can represent the Democratic Tech Fund. The DTF would like to join the Co-op Cloud Federation in order to establish a solid base for future collaboration.
The DTF is set up as a co-operative federation, with multi-stakeholder membership: to allow both individual as organisational membership, operational members (i.e. workers), collaborator members, council of steward members (elected) and institutional members (public and private funders).
A brief summary of the the intended goals of the DTF are as follows:
* **Build and provide the tech**: Generating working configurations of tech infrastructure and services that address actual, perceived needs, drawing on the reserves of free-libre open- source software and constructing practices of material infrastructure that are under the review and steering of the communities they service.
* **Mobilise awareness towards adoption**: highlighting the clear and present danger and our collective capacity to resist, re-make and re-imagine. There's a need for campaign work, media and visuals, and for intelligence and news about what has already been done.
* **Build the community**: nurturing local, regional and trans-regional communities and networks that are capable to articulate these alternatives, to make the change together and to sustain the economic base for radically re-oriented infrastructure.
Please see the latest Work-In-Progress [DTF concept note - v0.3](https://oficina.commonscloud.coop/s/No93qBkpxAsgYqE) for more details. Founding members include the [Free Knowledge Institute](https://freeknowledge.eu), [Commons Network](https://www.commonsnetwork.org) and [Fundación Platoniq / Goteo.org](https://goteo.org). The Free Knowledge Institute is also the fiscal host of the DTF. Please see the website of the [DTF](https://democratictech.fund) itself for more information.
DTF are happy to pay the current recommended federation membership fee.
Please feel free to join `#dtf2026:matrix.org` to keep up with DTF project developments.

View File

@ -1,5 +1,5 @@
---
title: Resolution 034
title: "Resolution 034: Extra budget for Escuela Común recipes"
---
- Topic: Budget 015: Extra budget for recipes needed by Escuela Común

View File

@ -53,6 +53,12 @@ I.e. `compose.smtp.yml`. These are used to provide non-essential functionality s
If you look at a `compose.yml` file and see a `configs` section, that means this compose file is putting files in the container. This might be used for changing default (vendor) configuration, such as this [fpm-tune.ini file](https://git.coopcloud.tech/coop-cloud/nextcloud/src/commit/28425b6138603067021757de28c639ad464e9cf8/fpm-tune.ini) used to adjust `php-fpm.` See [this handbook entry](/maintainers/handbook/#manage-configs) for more.
### Special environment variables
#### STACK_NAME
Our deployment runtime expects a specific naming convention for Co-op Cloud apps when they are deployed on the server. This is a case of lowercasing/underscoring the domain name, e.g. "foo.coopcloud.tech" -> "foo_coopcloud_tech". This is for the most part an internal implementation detail. However, it is sometimes useful to expose this variable to template configurations when trying to connect apps together via runtime networking. See ["How do I reference serices in configs"](/maintainers/handbook/#how-do-i-reference-services-in-configs) for a practical example.
## Manage configs
To add additional files into the container, you can use [Docker configs](https://docs.docker.com/engine/swarm/configs/). This usually involves the following:
@ -323,18 +329,15 @@ Sometimes the containers don't even have Bash installed on them. You had better
When referencing an `app` service in a config file, you should prefix with the `STACK_NAME` to avoid namespace conflicts (because all these containers sit on the traefik overlay network). You might want to do something like this `{{ env "STACK_NAME" }}_app` (using the often obscure dark magic of the Golang templating language). You can find examples of this approach used in the [Peertube recipe](https://git.coopcloud.tech/coop-cloud/peertube/src/commit/d1b297c5a6a23a06bf97bb954104ddfd7f736568/nginx.conf.tmpl#L9).
!!! warning "Here be timing dragons 🐉"
!!! warning "Here be `STACK_NAME` dragons 🐉"
Due to how `STACK_NAME` as an environment variable is initialized within `abra`, it won't be available *early enough* for use within config templates (`*.tmpl`) unless you **use it as an environment variable for one of your compose services**.
Ideally this is addressed in a newer version of `abra`, but for now, this workaround suffices ✅
`STACK_NAME` is a [**special environment variable**](/maintainers/handbook/#special-environment-variables) which `abra` generates for you and in the format the runtime deployment expects to see. If you want to expose this environment variable in your template configurations, you need to expose it explicitly to the `env: ...` stanza in your recipe compose configuration. An example follows below.
E.g.
```
```yaml
services:
web:
image: nginx:1.29.3
environment:
- ...
- STACK_NAME
```
@ -590,7 +593,7 @@ SECRET_JWT_SECRET_VERSION=v1 # charset=default,special
```
Options are:
* `default`: [source](https://github.com/decentral1se/passgen/blob/8404cb922dea92efa8c3514f0ec8c37ce12a880f/const.go#L23)
* `special`: [source](https://github.com/decentral1se/passgen/blob/8404cb922dea92efa8c3514f0ec8c37ce12a880f/const.go#L22C29-L22C43)
* `safespecial`: [source](https://git.coopcloud.tech/toolshed/abra/src/commit/6abaf7a094df1a96599af2c4cbae1769821ad17c/pkg/secret/secret.go#L182)
* `default,special`: mix of `default` and `special`

View File

@ -2,16 +2,28 @@
title: Maintainers
---
Welcome to the maintainers guide! Maintainers are typically individuals who have a stake in building up and maintaining our digital configuration commons, the recipe configurations. Maintainers help keep recipes configurations up to date, respond to issues in a timely manner, help new users within the community and recruit new maintainers when possible.
Welcome to the recipe maintainers guide! Recipe maintainers help build up and maintain our recipe configuration commons based on [`R025`](https://docs.coopcloud.tech/federation/resolutions/passed/025/).
<div class="grid cards" markdown>
- __New Maintainers Tutorial__
- __How to Become a Recipe Maintainer__
If you want to package a recipe and/or become a maintainer, start here :rocket:
If you want to become a recipe maintainer, start here :heart:
[Learn more](/maintainers/maintain){ .md-button .md-button--primary }
- __Package your First Recipe Tutorial__
If you want to package a recipe, start here :rocket:
[Get Started](/maintainers/tutorial){ .md-button .md-button--primary }
- __How to Upgrade a Recipe__
If you want to upgrade a recipe, start here 🤸‍♀️
[Start upgrading](/maintainers/upgrade){ .md-button .md-button--primary }
- __Packaging Handbook__
One-stop shop for all you need to know to package recipes :package:

View File

@ -0,0 +1,82 @@
---
title: How to Become a Recipe Maintainer
---
!!! warning
This guide is a work-in-progress following [`R025`](https://docs.coopcloud.tech/federation/resolutions/passed/025/) and the work to to implement this in [`#60`](https://git.coopcloud.tech/coop-cloud/traefik/issues/60) for the [traefik recipe](https://git.coopcloud.tech/coop-cloud/traefik). Please help us update this documentation with new conventions and practices that emerge.
## What does a recipe maintainer do?
A recipe maintainer takes care of one or more recipes. This includes reviewing issues and pull requests and applying application upgrades which are published upstream. The general expectations for what a recipe maintainer should carry out are defined in [`R025`](https://docs.coopcloud.tech/federation/resolutions/passed/025/).
If recipes are maintained by several maintainers, there is a greater chance of stability for all operators who deploy those recipe upgrades for end-users. Please consider becoming a maintainer for recipes which you rely on!
!!! note "We need More Recipe Maintainers!"
Since the publishing of [`R025`](https://docs.coopcloud.tech/federation/resolutions/passed/025/) there is a growing consensus that it is critically important that we recruit more recipe maintainers. The recipe configuration commons on its own is not enough. We also need to coordinate our maintenance work to ensure that everyone can benefit from smooth and stable upgrades.
## You can become a recipe maintainer!
Anyone who deploys a recipe can become a recipe maintainer. If you want to ensure that a recipe becomes stable and reliable, then you can become the maintainer. If you maintain a recipe alone, ask for help and encourage others to join in. The only way we can reduce the endless workload of application updates is to coordinate our work together.
### `README.md` and `MAINTENANCE.md`
You can start by reading The Maintainers Proposal: [`R025`](https://docs.coopcloud.tech/federation/resolutions/passed/025/). Check if there are maintainers mentioned in the `README.md` of the recipe repository and if there is a `MAINTENANCE.md` present. For example, for the traefik recipe, here is [the list of maintainers in the `README.md`](https://git.coopcloud.tech/coop-cloud/traefik/src/commit/8eaee04b5d9980a99fdad57677a4c72d7796da10/README.md?display=source#L8) and the maintainers guidelines in the [`MAINTENANCE.md`](https://git.coopcloud.tech/coop-cloud/traefik/src/commit/8eaee04b5d9980a99fdad57677a4c72d7796da10/MAINTENANCE.md). If there is no `MAINTENANCE.md`, copy the template below and create your own.
### Maintainers Team
It is important that only recipe maintainers have write permissions to the repository. As it currently stands, every member of the [Co-operators Team](https://git.coopcloud.tech/org/coop-cloud/teams/co-operators) has write permissions to all recipe repositories for convenience while we are missing enough maintainers.
To change this, create a new team on [`git.coopcloud.tech/coop-cloud/teams`](https://git.coopcloud.tech/org/coop-cloud/teams) for your specific recipe, e.g. `mycoolrecipe-maintainers`. Add yourself and any other maintainers and don't forget to add the recipe repository itself on the repositories tab. Remove your recipe repository from the [list of repositories for the Co-operators Team](https://git.coopcloud.tech/org/coop-cloud/teams/co-operators/repositories) so that write permissions are removed.
### Repository Permissions
Under `Branch Protection` in the recipe repository settings, create a new rule
for the `main` / `master` branch of your repository. Add your maintainer team
to the following list of permissions.
* Allow only maintainers to push directly to the main branch
* `Allowlist Restricted Push` > `Allowlisted teams for pushing`
* Allow only maintainers to approve pull requests
* `Restrict approvals to allowlisted users or teams` > `Allowlisted teams for reviews`
* Allow only maintainers to merge pull requests
* `Enable Merge Allowlist` > `Allowlisted teams for merging`
## Templates
### `MAINTENANCE.md` template
!!! warning
We are still considering if it is a good idea to create a `MAINTENANCE.md`
for every recipe repository. Maybe it is a better idea to make a single
`MAINTENANCE.md` on [docs.coopcloud.tech](https://docs.coopcloud.tech). We
look forward to seeing feedback on this from new maintainers.
See the [`MAINTENANCE.md`](https://git.coopcloud.tech/coop-cloud/traefik/raw/branch/master/MAINTENANCE.md) of the Traefik recipe.
### Pull request template
See the [`.gitea/PULL_REQUEST_TEMPLATE.md`](https://git.coopcloud.tech/coop-cloud/traefik/src/branch/master/.gitea/PULL_REQUEST_TEMPLATE.md) of the Traefik recipe.
## Where can maintainers find support?
### Chat
An active community exists in the [`#coopcloud-tech`](https://matrix.to/#/#coopcloud-tech:autonomic.zone?via=autonomic.zone) channel, which can answer your questions and help with issues. Please be patient when asking for support.
### Recipe Issue Tracker
If you're stuck on a problem, create an issue in your recipe's issue tracker. Users of your repository may contribute PRs, otherwise you can ask the community for support.
### Toolshed
If you're blocked by a problem in Coop Cloud's tooling, write a ticket to one of the [Toolshed](https://git.coopcloud.tech/toolshed) issue trackers. For example:
* [abra](https://git.coopcloud.tech/toolshed/abra/issues)
* [docs.coopcloud.tech](https://git.coopcloud.tech/toolshed/docs.coopcloud.tech/issues)
* [recipes.coopcloud.tech](https://git.coopcloud.tech/toolshed/recipes.coopcloud.tech/issues)
If you cannot find a repository to match your problem, you can write in the [organizing issues](https://git.coopcloud.tech/toolshed/organising/issues) tracker. (See: [migration notice](https://git.coopcloud.tech/toolshed/organising/issues/667))

View File

@ -0,0 +1,15 @@
---
title: How to Upgrade a Recipe
---
## Updating versions in the `abra.sh`
`#TODO`
## Backwards compatible environment variable changes
`#TODO`
## Creating new release notes
`#TODO`

View File

@ -118,7 +118,7 @@ Then `$ABRA_DIR` will be automatically picked up as `$PWD`. This is useful when
If you're on an environment where it's hard to run Docker, or command-line programs in general, you might want to install `abra` on a server instead of your local computer.
To install `abra` on the same server where you'll be hosting your apps, just follow [getting started guide](/operators/tutorial#deploy-your-first-app) as normal except for one difference. Instead of providing your SSH connection details when you run `abra server add ...`, just pass `--local`.
To install `abra` on the same server where you'll be hosting your apps, just follow [getting started guide](/operators/tutorial#deploy-your-first-app) as normal except for one difference. Instead of providing your SSH connection details when you run `abra server add ...`, just pass `--local` and specify the domain during deployment.
```
abra server add --local
@ -320,6 +320,36 @@ If you need to run a command within a running container you can use `abra app ru
If you need to run a command on a container that won't start (eg. the container is stuck in a restart loop) you can temporarily disable its default entrypoint by setting it in `compose.yml` to something like ['tail', '-f', '/dev/null'], then redeploy the stack (with `--force --chaos` so you don't need to commit), then [get into the now running container](#how-do-i-attach-to-a-running-container), do your business, and when done revert the compose.yml change and redeploy again.
## How can I modify/override the `compose.yml-file`?
If you need a customization of the `compose`-file, e.g., override a specific, hard coded value that is not present in the sample-env, add a custom volume, or add an environment variable that the image knows but which is not (yet) included in the `compose.yml` of the recipe, you can do so by using the `COMPOSE_FILE` environment variable ([more details in Docker docs](https://docs.docker.com/compose/how-tos/environment-variables/envvars/#compose_file)).
For details about how the two compose files are merged, consult the official [Docker docs](https://docs.docker.com/compose/how-tos/multiple-compose-files/merge/).
If it's not a special or edge case, perhaps consider modifying the original recipe / racing a feature request so everyone can benefit from your conceptual work?
### Example
The upstream image of your `app` allows you to modify the SMTP port with an environment variable called `SMTP_PORT`, but the recipe's maintainers didn't include it in the compose file because they didn't have in mind anyone would need a non-standard port. So you can't simply add `SMTP_PORT` to your `yourapp.example.com.env`, because it won't find its way into the running container.
For a quick fix, you could now create a file, e.g. `yourapp.example.com.compose.override.yml` (naming is up to you) with the content:
```
services:
app:
environment:
SMTP_PORT: 25
```
and add to your `yourapp.example.com.env`
```
COMPOSE_FILE="compose.yml:../../servers/<YOUR-SERVER>/yourapp.example.com.compose.override.yml
```
_Make sure you include the original `compose.yml` and place the `yourapp.domain.compose.override.yml` directly alongside of your `yourapp.example.com.env`, or change the (relative) path respectively._
This will now add/overwrite the `SMTP_PORT` environment variable of the `app` container.
`
## Can I run Co-op Cloud on ARM?
`@Mayel`:

View File

@ -36,7 +36,8 @@ Otherwise, here are the step required:
ssh <server-domain>
# docker install convenience script
wget -O- https://get.docker.com | bash
# not suitable for production environments - refer to the script header for alternatives
curl https://get.docker.com | bash
# check that docker was installed correctly
sudo docker run hello-world
@ -84,6 +85,10 @@ Where `116.203.211.204` can be replaced with the IP address of your server.
You can use a tool like `dig` on the command-line to check if your server has the necessary DNS records set up. Something like `dig +short <domain>` should show the IP address of your server if things are working.
??? question "Can I use DynDNS with a home server?"
Yes. If your DNS provider does not allow you to set a *. A-Record, you may still be able to use a *. CNAME-Record to your example.com domain.
### Install `abra`
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)):
@ -183,9 +188,8 @@ You need to keep port `:80` and `:443` free on your server for web proxying to y
??? question "Do you support multiple web proxies?"
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.
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:**

View File

@ -94,6 +94,9 @@ nav:
- federation/proposals/federation.md
- "Resolutions":
- federation/resolutions/index.md
- "Draft":
- federation/resolutions/index.md
- federation/resolutions/draft/035.md
- "Passed":
- federation/resolutions/passed/001.md
- federation/resolutions/passed/002.md
@ -126,19 +129,20 @@ nav:
- federation/resolutions/passed/032.md
- federation/resolutions/passed/031.md
- federation/resolutions/passed/033.md
- federation/resolutions/passed/034.md
- "Stalled":
- federation/resolutions/stalled/013.md
- federation/resolutions/stalled/030.md
- "In Progress":
- federation/resolutions/index.md
- federation/resolutions/in-progress/034.md
- federation/resolutions/in-progress/036.md
- "Minutes":
- federation/minutes/index.md
- "Recently":
- federation/minutes/2025-12-28.md
- "Archive":
- federation/minutes/2024-08-15.md
- federation/minutes/2024-04-17.md
- federation/minutes/2024-03-29.md
- "Archive":
- federation/minutes/2024-02-01.md
- federation/minutes/2022-03-03.md
- federation/minutes/2023-05-03.md