This is an automated email from the ASF dual-hosted git repository. tbrasmussen pushed a commit to branch update-gradle-readme-and-minor-css-fix in repository https://gitbox.apache.org/repos/asf/grails-static-website.git
commit 4a7199749238b635596393b08953f94afddcf34f Author: Thomas Rasmussen <[email protected]> AuthorDate: Tue Mar 17 20:22:21 2026 +0100 Update README to use jwebserver instead of MAMP Installing Apache httpd, MySQL and PHP seems a bit overkill to serve a static website. Suggest using jwebserver from JDK 19+ instead --- README.md | 22 ++++++++++++++++------ docs/mamp.png | Bin 593821 -> 0 bytes 2 files changed, 16 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index e602d0e0df2..8569380ef8f 100644 --- a/README.md +++ b/README.md @@ -74,20 +74,30 @@ The output can be found in the `build/dist` directory. ```bash ./gradlew buildGuide --console=plain - ``` The output can be found in the `build/dist` directory. -## Running the website locally +This will generate links to https://grails.apache.org if you want the links to point to your local webserver you need to +set this environment variable before running the build commands (port number depend on webserver...): + +```bash +export GRAILS_WS_URL=http://127.0.0.1:8000 +``` -The easiest way to work locally is to generate the site and setup your Webserver to serve build/dist. +## Running the website locally +The easiest way to work locally is to generate the site and set up your Webserver to serve build/dist. -### Using MAMP +### Using jwebserver -Go to [MAMP](https://www.mamp.info/en/mamp/) for installation instructions: +JDK 19+ comes with a simpel webserver called [jwebserver](https://docs.oracle.com/en/java/javase/25/docs/specs/man/jwebserver.html) that can be used for serving static files: - +```bash +$ jwebserver -d $(pwd)/build/dist +Binding to loopback by default. For all interfaces use "-b 0.0.0.0" or "-b ::". +Serving /home/user/grails-static-website/build/dist and subdirectories on 127.0.0.1 port 8000 +URL http://127.0.0.1:8000/ +``` ### Using Python diff --git a/docs/mamp.png b/docs/mamp.png deleted file mode 100644 index c77674fd59a..00000000000 Binary files a/docs/mamp.png and /dev/null differ
