Operating System CentOS

Pagekit CMS Is Discontinued: Status and a Maintained Alternative (Grav)

Pagekit CMS was archived in December 2023 and gets no fixes. Here is its status and how to install Grav, a maintained alternative, on AlmaLinux 9 or Rocky Linux 9.

Pagekit is no longer a safe choice for a new site. The project's GitHub repository was archived by its owner on 1 December 2023 and is read-only, the last release (1.0.18) dates from 20 January 2020, and the project website no longer resolves. This page explains what that means if you were planning to install Pagekit on CentOS 7 or a FreeBSD FAMP stack, and shows how to install Grav, a maintained PHP CMS of similar weight, on AlmaLinux 9 or Rocky Linux 9.

What Pagekit was and where it stands

Pagekit was an open source, modular CMS written in PHP on top of Symfony components, with a Vue.js admin interface and a marketplace for themes and extensions. It ran on Apache or NGINX with MySQL or SQLite and was popular for small sites and blogs.

  • Last release: 1.0.18, 20 January 2020.
  • Repository: archived on 1 December 2023. No issues, pull requests or security fixes are accepted.
  • Platform: the 1.0 series was written for PHP 5.5 to 7.x. Do not expect it to run on the PHP 8 releases that current distributions ship, and nobody is fixing that.
  • Operating systems: CentOS 7 reached end of life on 30 June 2024 and FreeBSD 11 is long out of support, so the platforms older tutorials used are gone as well.

An unmaintained CMS on an unsupported PHP version, exposed to the internet, is a liability. If you already run Pagekit, plan a migration: export your pages and posts from the database, copy the storage directory with your uploads, and rebuild the site on a maintained system.

A maintained alternative: Grav

Several CMSs cover the same ground (WordPress, Backdrop CMS, Statamic, Grav). Grav is the closest in spirit: small, fast, Markdown-based, with an optional admin panel, and it needs no database at all, which removes a whole layer from a small VPS. Grav 2.x requires PHP 8.3.11 or newer with the curl, ctype, dom, gd, json, libxml, mbstring, openssl, session, simplexml and zip extensions, and on Apache it needs mod_rewrite with AllowOverride All.

Install Grav on AlmaLinux 9 or Rocky Linux 9

Run these commands as a user with sudo rights on a fresh server. The default PHP in the 9 family is too old for Grav 2, so enable the PHP 8.3 module stream first.

sudo dnf module reset php -y
sudo dnf module enable php:8.3 -y
sudo dnf install -y httpd php php-gd php-mbstring php-xml php-pecl-zip php-opcache unzip

Confirm that the PHP version is at least 8.3.11:

php -v

Download the Grav package that includes the admin panel and unpack it into the web root. Copy the hidden files too, because Grav depends on its .htaccess.

cd /tmp
curl -L -o grav-admin.zip https://getgrav.org/download/core/grav-admin/latest
unzip -q grav-admin.zip
sudo cp -a grav-admin/. /var/www/html/
sudo chown -R apache:apache /var/www/html

Allow .htaccess overrides for the site by creating /etc/httpd/conf.d/grav.conf:

<Directory "/var/www/html">
    AllowOverride All
    Require all granted
</Directory>

SELinux is enforcing by default and blocks the web server from writing to its own document root. Grav has to write caches, logs, uploads and configuration, so label the tree as writable web content:

sudo dnf install -y policycoreutils-python-utils
sudo semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/html(/.*)?"
sudo restorecon -R /var/www/html

Start the services and open the firewall:

sudo systemctl enable --now php-fpm httpd
sudo firewall-cmd --permanent --add-service=http --add-service=https
sudo firewall-cmd --reload

Open http://203.0.113.10/admin (use your server's address or domain). Because no accounts exist yet, the admin panel asks you to create the first administrator. Add a TLS certificate before you put real content on the site, since the admin login is otherwise sent in clear text.

Verify the installation

The front page should show the default Grav site, and /admin should show the dashboard after you log in. If pages other than the home page return 404, the rewrite rules are not being applied: check that grav.conf exists and restart httpd. If you see permission errors, check ownership and the SELinux label:

ls -ldZ /var/www/html /var/www/html/cache

Grav's own documentation covers themes, plugins and updates: see the Grav installation guide and the requirements page.

Frequently asked questions

Can I still download and run Pagekit?

The archived source is still on GitHub, but it receives no fixes of any kind and targets PHP versions that are themselves end-of-life. Running it on a public server means accepting unpatched code in both the CMS and the PHP runtime it needs.

Is there a maintained fork of Pagekit?

The upstream repository names no successor, and no fork has taken over the project with regular releases. Treat Pagekit as finished and move to a different CMS rather than waiting for a revival.

Does this apply to FreeBSD as well?

Yes. Pagekit's status is the same on every operating system. Grav runs on FreeBSD too: it needs only a web server and PHP 8.3.11 or newer with the extensions listed above, with no database.

Is there an importer from Pagekit to another CMS?

Not an official one. Pagekit stores pages and blog posts in its MySQL or SQLite database, largely as HTML or Markdown, so small sites are usually migrated by exporting those tables and recreating the pages by hand.

Share story:

Continue reading other guides on How VPS.