Installing "custom" apps

While YunoHost has many apps available in the catalog, you may want to install apps that are not available in the official catalog, or set up your very own website that you crafted using HTML / CSS / PHP ..

Installing your very own webapp

A special application exists called My webapp.

It can be seen as "an empty shell" in which you can drop your own HTML, CSS, JS, etc files through SFTP or other means. It also supports PHP, and an SQL database can be initialized.

Adding a reverse proxy to an app that you manually installed, for example using Docker

While YunoHost apps do not use Docker for reasons that are beyond the scope of this page, you can manually install Docker apps on your server (assuming you know what you're doing and won't tinker too much with the base system ...). However, this is not limited to Docker, you may have deployed an app "manually" using Python, Ruby or another language, and such an app usually listens on a specific port.

Once your app or container is set up, you will probably need to actually expose the container on the web on a specific URL. This can be done using another special app called Redirect.

Make sure to choose the reverse proxy mode, and point it to something like http://127.0.0.1:PORT where PORT is the port of your custom app.

It will add the appropriate configuration bits in Nginx, SSOwat and a tile in the user portal.

Adding a custom tile in the portal pointing to an external app

The Redirect app can also be used to add a "shortcut" tile in the user portal that points to an app or page located on a completely different server. Make sure to use the "explicit redirect" mode and the URL of the external page or app.

Generally, you should refrain from manually tinkering and installing apps, except if you are sure they will not interfere with your server. YunoHost proposes two generic apps to help you out: