Page
Documentation
Documentation is split into Site Management guides for people running sites and Technical guides for operators and developers. The generated /docs/ index shows both tracks.
Site Management
- Site Owner Guide explains contributor product mode, pages, posts, media, design, features, billing, and Account / Help.
- Content, Design, And Media covers editing workflows, public design, private source assets, Resource Downloads, previews, search, and retention.
- Managing Contributor Sites covers requests, hosted sites, blueprints, service plans, provider inheritance, governance, and federated review.
Technical
- Technical Architecture explains the engine, storage, static renderer, capability policy, modules, media pipeline, and contributor mode.
- OpenBSD 7.4 Installation is the supported production install path.
- Creating Modules explains first-party module definition, plan gates, capabilities, rendering, routes, schema, media, and tests.
Quick Install
perl install/openbsd-install.pl --dry-run --domain example.com --public-root-name example-site
doas perl install/openbsd-install.pl --domain example.com
doas perl /usr/local/www/desertcms/tools/openbsd-validate.pl --domain example.com
Runtime Layout
/usr/local/www/desertcms/ application code
/etc/desertcms.conf main instance config
/var/desertcms/ main instance data
/var/desertcms/originals/ private source assets
/var/desertcms/backups/ backup archives
/var/www/htdocs/desertcms-site/ generated public site
/var/www/acme/ ACME challenge root
/var/www/run/desertcms.sock slowcgi socket
Operations Cheat Sheet
doas rcctl restart desertcms_slowcgi
doas httpd -n && doas rcctl reload httpd
doas su -m _desertcms -c 'env DESERTCMS_CONFIG=/etc/desertcms.conf perl /usr/local/www/desertcms/bin/desertcms-maint.pl rebuild'
doas su -m _desertcms -c 'env DESERTCMS_CONFIG=/etc/desertcms.conf perl /usr/local/www/desertcms/bin/desertcms-maint.pl backup'
Downloads
Use the Download page for release archives and checksums. The source archive is best for development. The OpenBSD runtime bundle is the operational package for a server install.
desertcms-source-2.0.2.tar.gz - 1.6 MB
desertcms-openbsd-runtime-2.0.2.tar.gz - 1.4 MB