This document is a WORK IN PROGRESS.
This is just a quick personal cheat sheet: treat its contents with caution!

`webapp-config` with Gentoo¶

webapp-config is Gentoo's installer for web based applications. It is used for automatic setup of web applications in virtual hosting environments.

Reference(s)

Table of content¶

Install webapp-config:

# emerge -a webapp-config

Configure webapp-config:

# vi /etc/vhosts/webapp-config
    > ...
    > vhost_server="nginx" # e.g. for nginx server
    > ...

Install a web app (e.g. Nextcloud):
```
# webapp-config -I nextcloud <version>
```
List all the installed virtual copies:
```
# webapp-config --list-installs
```
Outputs the app name and app version of the installed apps (e.g. Nextcloud):
```
# webapp-config --show-installed --host <hostname> -d nextcloud
```
Update a previously installed web app (e.g. Nextcloud):
```
# webapp-config -U nextcloud <version> --host <hostname>
```
Then?: "To avoid timeouts with larger installations, you can instead run the following command from your installation directory: $ ./occ upgrade"

Remove an installed web app (e.g. Nextcloud):
```
# webapp-config -C nextcloud <version>
```

If this cheat sheet has been useful to you, then please consider leaving a star here.