Google Git
Sign in
apache/roller/caac9f25ae329cfa7f07633588c46be6c73ff0cb
commit
caac9f25ae329cfa7f07633588c46be6c73ff0cb
[log]
author
David M. Johnson <snoopdave@apache.org>
Sat Aug 29 10:21:24 2026 -0400
committer
David M. Johnson <snoopdave@apache.org>
Sat Aug 29 16:39:57 2026 -0400
tree
9a6269e54b8ec35755e53ca7e4795a27926b8381
parent
f1422f4448f9ff502600069a1c316bafea02b3d7 [diff]
Move frontpage selection into the administrator setup workflow

Setup is a read-only bootstrap page. Choosing the initial frontpage weblog is a
separate global-administrator action reached by POST (FrontpageSetup); later
changes go through global configuration, which resolves the handle through the
shared FrontpageSettings service. The service stores the weblog's canonical
handle, treats a missing aggregation checkbox as false, writes both properties
before a single flush, and clears the site-wide, page and feed caches so the
change is visible on this node. save() rejects non-POST requests.

Peers pick the change up when their own cache entries expire; Roller has no
cross-node invalidation transport and this does not add one.

Claude-Session: https://claude.ai/code/session_01A1fhY1E2PCFU6UAPXu2WtV
8 files changed
tree: 9a6269e54b8ec35755e53ca7e4795a27926b8381
  1. .github/
  2. app/
  3. assembly-release/
  4. binary-includes/
  5. db-utils/
  6. docker/
  7. docs/
  8. it-selenium/
  9. testing/
  10. .asf.yaml
  11. .gitignore
  12. CONTRIBUTING.md
  13. doap_roller.rdf
  14. docker-compose.yml
  15. Dockerfile
  16. LICENSE.txt
  17. nbactions.xml
  18. NOTICE.txt
  19. pom.xml
  20. README.md
  21. version-rules.xml
README.md

Apache Roller

Apache Roller is a Java-based, full-featured, multi-user and group-blog server suitable for blog sites large and small. Roller is typically run with Apache Tomcat and MySQL. Roller is made up of the following Maven projects:

  • roller-project: Top level project
  • app: Roller Weblogger webapp, JSP pages, Velocity templates
  • assembly-release: Used to create official distributions of Roller
  • docs: Roller documentation in ASCII Doc format
  • it-selenium: Integrated browser tests for Roller using Selenium

Documentation

The Roller Install, User and Template Guides are available in ODT format (for OpenOffice or LibraOffice):

For more information

Hit the Roller Confluence wiki:

Installing Roller

If you want to run Roller in production, then you should down load the latest official release and install it by following the Installation Guide, which you can find at the documentation link: https://github.com/apache/roller/tree/master/docs.

Quick start: Running via Maven

You probably should not run Roller in production using this technique, but it‘s a relatively easy way to try Roller for yourself. Assuming you’ve got a UNIX shell, Java, Maven and Git:

Get the code:

$ git clone https://github.com/apache/roller.git

Compile and build Roller:

$ cd roller
$ mvn -DskipTests=true install

Run Roller in Jetty with an embedded Derby database (for testing only):

$ mvn jetty:run

Once Jetty is up and running browse to http://localhost:8080/roller to try to Roller.

Quick start: running via Docker

Another way to try Roller is to use Docker. This is actually easier than running via Maven because you do not need Maven or Java. If you‘ve got Docker, here’s how you can run Roller for demo purposes.

Get the code:

$ git clone https://github.com/apache/roller.git

Run Docker Compose to build and launch Roller along with a PostgreSQL database:

$ cd roller
$ docker-compose up

It will take a while to build and start the Docker image. Once it's done browse to http://localhost:8080/roller to try Roller.