[Grav] Flat-file CMS package

Moderation note

lithrel was the previous maintainer of this package, TitusPiJean seem to be the new one, so I (ljf) change the author of this message to let TitusPiJean do some change in the Grav presentation

Grav for YunoHost

Integration level Status Maintainership
Install Grav with YunoHost

This package allow you to install Grav quickly and simply on a YunoHost server. If you don’t have YunoHost, please see here to know how to install and enjoy it.

What is Grav?

Grav is a modern open source flat-file CMS. It means you can publish your website directly from text files. This package ships an admin interface, that enables control and page editing through your browser.

Shipped version: 1.7.15


YunoHost specific features and limitations

  • :key: SSO login is supported.
  • :lock: You can designate admins with the permissions panel.

Supported architectures

All architectures supporting nginx and php.

Links, documentation, and bug reporting


YunoHost package

Developers information

:warning: Only if you know what you are doing AND want to switch to an unstable branch for testing or coding. Instead of merging directly into master, please do your pull request to the testing branch

To install the testing branch:

sudo yunohost app install https://github.com/YunoHost-Apps/grav_ynh/tree/testing --debug

To upgrade to the testing branch (replace grav by the actual instance ID if more instances are installed):

sudo yunohost app upgrade grav -u https://github.com/YunoHost-Apps/grav_ynh/tree/testing --debug 


Master branch

  • Before 2018-09-03: see Github’s commit history
  • 2018-09-12: Package rewrite, adding Jibec and tituspijean as maintainers
  • 2018-09-16: Fix upgrade resetting the website
  • 2018-09-20: Upgrade to Grav v1.5.2
  • 2018-10-27: Upgrade to Grav v1.5.3
  • 2020-07-10: Upgrade to Grav 1.6.26, integrate LDAP plugin and PHP versions handling
  • 2020-10-10: Upgrade to Grav 1.6.28, add issue and PR templates
  • 2021-06-08: Upgrade to Grav 1.7.15, use README generator

Testing branch

  • Go checkout the branch itself and current PRs on GitHub.


  • lithrel (previous)
  • cyp (previous)
  • jibec (current)
  • tituspijean (current)

Hi, I am very interested in the packaging of Grav.
I am not an expert enough to bring you help right now, but I am learning!

Thanks for the work, hope other people might help! (-;

I’m also very interested in the package. How can we get some help from experienced people?

Hello, we can help yes. What do you want to improve on this package? Or do you want to package other things?

improve this package: it would be nice if one could install this app on an other path than the root of the domain, so that one can keep running other installed apps.

Better late than never \o/
I just pushed a new version of the package for Grav, which now works both for root and subfolder install.
The readme has been updated with more detailed options.

Mieux vaut tard que jamais \o/
Je viens de publier une nouvelle version du paquet pour Grav, qui fonctionne désormais pour les installations à la racine d’un domaine et en sous-dossier.
Le readme a aussi été mis à jour avec un peu plus de détails et une version fr.


A community version is here : https://www.github.com/YunoHost-Apps/grav_ynh


1 Like

I have sent a PR to refactor and update the app, based on the latest PR by @nemsia (which has not been merged since late May) and the latest example_ynh standard.

I intend to investigate LDAP/SSOwat integration if possible. @lithrel has a good lead with the LDAP extension, but I could not make it work with my early tests.

Hello all,
A new release is available to test.

  • testing branch : 2018-10-07
    • Upgrade to version 1.5.2
    • Launch command after upgrade to update plugins

Hi all, new releases are available. :slight_smile:

  • master branch: 2018-10-20
    • Upgrade to version 1.5.2
  • testing branch: 2018-10-21
    • Upgrade to version 1.5.3
1 Like

Hi all, a new release is available. :slight_smile:

  • master branch: 2018-10-27
    • Upgrade to version 1.5.3
  • testing branch: merged.

Is someone planning to update the package ?

Thx :slight_smile:

Short answer: Not easily until Debian Buster is out. It can be done but needs packagers willpower.


I worked on the package https://github.com/YunoHost-Apps/prettynoemiecms_ynh which also needs a php version that is not available in Debian Strech. It takes a lot of time and energy to find ways to use the new php version. I gave up, not enough time for that and it’s rather complex

1 Like

Just to say, I’ve updated the package prettynoemiecms:

Need some love and review :slight_smile:

(Sorry to pollute this topic)

1 Like

Juste push the code “as is” on the web if someone/a packager is willing to continue to work on it.
It doesn’t work, don’t try it on your server!!

Hi all,

  • testing branch: 2020-07-07, PR #39
    • Upgrade to version 1.6.26
    • Integrate LDAP login extension
    • Integrate with new permissions system (admin permission to allow users to log into the admin panel)
    • Integrate with new PHP version handling
    • Fix CI badge
  • Merged into master on 2020-07-10

Hi all,

It has been a while since we notified upgrades here… :scream:

  • testing branch: 2021-04-07, PR #67
    • Upgrade to version 1.7.10
    • Allow plugin upgrades to fail, and display a warning to have the user perform them manually
    • Various code improvements

Please report any issue! Merging in 3 days if no issues arise.

1 Like


I’ve just tried to install Grav on Yunohost 4.1.8 (stable).
But … after having clicking on the install button in the admin web interface, it went to nowhere : it turns and turns but nothing happend.

Hi, thanks for the report. :slight_smile: Can you try installing Grav from the command line?

yunohost app install grav

Yep ! Done and … success ! Thank you.

So: do you think the previous error came from something else ?

1 Like