App installation

In addition to manual guides in the Uberspace Lab we also provide a command to install applications automatically:

[isabell@moondust ~]$ uberspace app install wordpress
[...]

This will load an Ansible playbook from the public Lab repository and start it with default configurations. You will be asked to confirm the configuration before actually running any changes.

Dry run installation

You can use --dry to just check the whole installation first without changing anything on your Asteroid:

[isabell@moondust ~]$ uberspace app install wordpress --dry
...
OK: playbook started (dry-run)
...

This will enable ansible check-mode and show what tasks would be changed when running without --dry, some tasks will be skipped as they cannot be executed in check-mode.

Custom configuration

Similar to the guides, the default playbook configurations assume a fresh Asteroid instance with no other apps installed or running, and with the default domains, email addresses, and other settings in place.

You can change configurations with usage of multiple --var config=value to your personal needs. For example:

[isabell@moondust ~]$ uberspace app install wordpress --var domain=example.com --var locale=de_DE
...
 Wordpress
 | installation_path:  /var/www/virtual/isabell/html
 | db_name:            isabell_wordpress
 | locale:             de_DE                             <--- adapted
 | title:              isabell's new Website
 | domain:             example.com                       <--- adapted
 | admin_username:     isabell
 | admin_mailaddress:  isabell@uber.space
 | admin_password:     RANDOM
...

Logging

You will find logs for the installation at ~/logs/app_playbooks/.

The command creates a data directory in ~/.config/uberspace/app_playbooks where the playbook and all information about the installation are stored. Have a look at the ansible-runner documentation for more information about the structure and contents of that directory.

Install custom playbooks

Instead of a simple application name you can also provide a URL or local path to execute custom playbooks:

[isabell@moondust ~]$ uberspace app install https://example.com/playbook.yaml
[...]
[isabell@moondust ~]$ uberspace app install ~/playbook.yaml
[...]

Lab playbooks

You can find the preconfigured playbooks for installation in the Lab repository.