Skip to content
Switch branches/tags


Failed to load latest commit information.
Latest commit message
Commit time

Redirect for YunoHost

Integration level
Install Redirect with YunoHost

Lire ce readme en français.

This package allows you to install Redirect quickly and simply on a YunoHost server. If you don't have YunoHost, please consult the guide to learn how to install it.


This application allows to integrate a custom tile in YunoHost's user portal. Typical use cases include:

  • visible 301/302 redirect : having a "virtual" app tile that's just a redirection to another url or external website
  • invisible redirect / reverse-proxy : creating an app tile for a local app listening on a specific port, or a Docker container, or an app hosted on another machine

In technical terms: this app only adds a NGINX configuration snippet with either redirect or proxy_pass rule, and a YunoHost tile + appropriate SSOwat configuration.

Shipped version: 1.0.0~ynh5

Disclaimers / important information

Redirect type

Visible redirect

The client will be redirected to another url or external website

  • ->
  • ->

Invisible redirect (a.k.a "reverse-proxy")

Visitor's address bar will remain the same. Typically used to integrate into YunoHost a manually-installed app into the portal.

  • ->

IMPORTANT: you may have to further tweak the redirect.conf in the nginx configuration, depending on your needs!

IMPORTANT: Many apps do not support being redirected to a different path due to relative links! This means that some apps being hosted for example on MUST be redirected to http://domain.tld/app/ and NOT http://domain.tld/someotherapp/. For example : an Odoo Docker container runs on You will not be able to redirect it to http://domain.tld/odoo/ ! You have to redirect it to the root, so for example http://odoo.domain.tld/

Documentation and resources

Developer info

Please send your pull request to the testing branch.

To try the testing branch, please proceed like that.

sudo yunohost app install --debug
sudo yunohost app upgrade redirect -u --debug

More info regarding app packaging: