xwiki/README.md

# xwiki

> One line description of the recipe

<!-- metadata -->

* **Category**: Apps
* **Status**: 0
* **Image**: [`xwiki`](https://hub.docker.com/r/xwiki), 4, upstream
* **Healthcheck**: No
* **Backups**: No
* **Email**: No
* **Tests**: No
* **SSO**: No

<!-- endmetadata -->

## Quick start

* `abra app new xwiki --secrets`
* `abra app config <app-name>`
* `abra app deploy <app-name>`

> Warning: trying to access <app-name> before db instance finishes initialization results in failure to initialize the xwiki instance, recommended to wait for about 5 minutes (that is plenty of time) before accessing the app from your browser.

## How to edit configs


Method 1: You can mount the volume `xwiki_cfg` in `rw` mode, navigate to the files, and make the edits.

Method2: You can also use `abra app cmd`, here is an example:

```
$ abra app cmd -l <app-name> edit_config
Which config file do you wish to edit?

/usr/local/tomcat/webapps/ROOT/WEB-INF/xwiki.cfg
/usr/local/tomcat/webapps/ROOT/WEB-INF/xwiki.properties
/usr/local/tomcat/webapps/ROOT/WEB-INF/hibernate.cfg.xml
/usr/local/tomcat/webapps/ROOT/WEB-INF/classes/logback.xml
/usr/local/tomcat/webapps/ROOT/WEB-INF/web.xml
Enter file name (without the path)
web.xml
Enter file path (including the file name)
/usr/local/tomcat/webapps/ROOT/WEB-INF/web.xml
Pulling web.xml from the app

web.xml is temporarily available

edit the file, save and exit, then press enter to continue


Moving the edited file to the app

deleting the local copy

Done!
```

TODO: on macos, the associative arrays won't work (declare -A throws an error)

You can use a brew version of bash to make it work, but abra currently [defaults to /bin/bash](https://git.coopcloud.tech/coop-cloud/abra/src/branch/main/cli/app/cmd.go#L98)

To simplify the interactive script above, we would first need abra to allow us to choose the shell path.

For more, see [`docs.coopcloud.tech`](https://docs.coopcloud.tech).