Tutorial: Install and open an app

Goal: Understand the install → domain/path → SSO → verify loop without breaking production apps.

Caution: Only install apps you intend to keep, or remove them when finished. Prefer a spare subdomain.

Prerequisites

• Admin access (yunohost CLI)
• Domain already in yunohost domain list with working cert
• First day complete

1. List catalog vs installed

yunohost app list
# catalog browse is interactive/UI; CLI install uses app id from catalog

2. Install (example shape)

# Replace with a real app id and answer prompts carefully
yunohost app install <app_id>

The installer will ask for domain, path, and admin options. Prefer a dedicated subdomain for root-path apps.

3. Confirm placement

yunohost app info <app_id>
yunohost app map
ls /etc/nginx/conf.d/

4. Verify HTTPS and SSO

curl -sI https://<domain>/<path> | head -15

Browser: log in via SSOwat if the app is protected; confirm logout does not strand cookies oddly.

5. Optional cleanup

yunohost app remove <app_id>

Success criteria

• [ ] App listed in yunohost app list
• [ ] Nginx site includes present under /etc/nginx/conf.d/
• [ ] HTTPS responds
• [ ] You can find the app again in Apps reference

Ops later: Upgrade apps · Backup