This package allows you to install Docker Container quickly and simply on a YunoHost server. If you don't have YunoHost, please consult the guide to learn how to install it.
Deploy and manage Docker containers on your YunoHost server, each accessed via a YunoHost domain with NGINX reverse proxy. Single-container apps work out of the box; multi-container setups (e.g. web + database) are supported by installing each container as its own instance and attaching them to a shared Docker network.
Shipped version: 1.0~ynh1
Install once, point to the image, done. Typical fits:
| Image | What it is |
|---|---|
vaultwarden/server |
Password manager |
gitea/gitea |
Git hosting |
ghost |
Blogging platform |
freshrss/freshrss |
RSS reader |
uptime-kuma/uptime-kuma |
Uptime monitoring |
joplin/server |
Notes sync server |
nginx:alpine |
Static file server |
Multiple containers can communicate over a user-defined Docker network. Install each container as a separate app instance, assign them the same network name in the install form, and reference each other by container name. See DOCKER_IMAGES.md for concrete recipes. Examples:
| App | Recipe |
|---|---|
| Moodle + MariaDB | MariaDB instance + Moodle instance on a shared network |
| Nextcloud + MariaDB | Same pattern, MYSQL_HOST=<mariadb-instance-name> |
| WordPress + MariaDB | Same pattern with WORDPRESS_DB_HOST |
For apps with deeper YunoHost integration requirements (LDAP/SSO, automatic DB provisioning, native backup hooks), a dedicated _ynh package remains the recommended path — this app trades that integration for flexibility and speed of setup.
- Docker must be installed on your server before installing this app (
sudo apt install docker.io) - This app does not integrate with YunoHost's SSO/LDAP — each container runs as an independent service
- This app will not work if YunoHost itself is running inside a Docker container
- Only data stored in the mounted
/datavolume is included in YunoHost backups — data stored elsewhere inside the container is lost on upgrade - Running the upgrade action re-pulls the image and recreates the container
- YunoHost Store: https://apps.yunohost.org/app/docker_container
- Report a bug: https://github.com/verzog/docker_ynh/issues
Please send your pull request to the testing branch.
To try the testing branch, please proceed like that:
sudo yunohost app install https://github.com/verzog/docker_ynh/tree/testing --debug
or
sudo yunohost app upgrade docker_container -u https://github.com/verzog/docker_ynh/tree/testing --debugMore info regarding app packaging: https://yunohost.org/packaging_apps