update the WAR install docs

Author: zspitzer

docs/04.guides/02.installing-lucee/03.osx/01.installing-tomcat-and-lucee-on-os-x-using-the-lucee-war-file/page.md

@@ -3,37 +3,64 @@ title: Installing Tomcat and Lucee on Mac OS X using the Lucee WAR file
 id: running-lucee-installing-tomcat-and-lucee-on-os-x-using-the-lucee-war-file
 ---
 
-Download a copy of Apache Tomcat 8.5 core, available at the [Tomcat download page](https://tomcat.apache.org/download-80.cgi).
+This guide walks you through deploying Lucee as a WAR file to Apache Tomcat on macOS. This is a lightweight setup ideal for development or small deployments where you want full control over your servlet container.
 
-Install Tomcat by extracting the downloaded archive. Extract the archive to your home folder, /Users/<username>. For convenience, you can rename the resulting folder from //apache-tomcat-8.5.29// to //tomcat//.
+By the end of this guide, you'll have Lucee running at `http://localhost:8080/` with access to both the Server and Web admin interfaces.
 
-1. Go into tomcat/webapps/. Delete the /ROOT/ folder and /ROOT.war/.
+## Prerequisites
 
-2. Next, go to the [Lucee download page](https://lucee.org/downloads.html) and download the latest lucee war file.
+- **Java 11 or higher** - Lucee 6.x requires Java 11+. You can install via Homebrew: `brew install openjdk@21`
+- **Apache Tomcat** - Version depends on your Lucee version:
+  - **Lucee 6.x** (javax-based): Use [Tomcat 9.x](https://tomcat.apache.org/download-90.cgi)
+  - **Lucee 7+** (jakarta-based): Use [Tomcat 10.x](https://tomcat.apache.org/download-10.cgi) or [11.x](https://tomcat.apache.org/download-11.cgi)
 
-3. Rename the lucee war file to /ROOT.war/ (note the capitalization).
+## Installation Steps
 
-4. Copy the renamed /ROOT.war/ file into tomcat/webapps/.
+1. Extract Tomcat to your home folder `/Users/<username>/`. For convenience, rename the folder to `tomcat`.
 
-5. Create a startup.sh file in tomcat/ with the following contents, replacing "\<username\>" with your username to provide the literal path:
+1. Go into `tomcat/webapps/`. Delete the `/ROOT/` folder and `/ROOT.war/`.
 
-> \# set the path to Tomcat binaries
-> export CATALINA_HOME=/Users/\<username\>/tomcat9
-> 
-> \# set the path to the instance config, i.e. current directory if this file is in the CATALINA_BASE directory
-> export CATALINA_BASE=/Users/\<username\>/tomcat9
-> 
-> EXECUTABLE=${CATALINA_HOME}/bin/catalina.sh
-> exec $EXECUTABLE run
+1. Go to the [Lucee download page](https://download.lucee.org/) and download the latest Lucee WAR file.
 
-6. In Terminal, cd into the tomcat directory and then execute the following command to start Lucee
+1. Rename the Lucee WAR file to `ROOT.war` (note the capitalization).
 
-> ./startup.sh
+1. Copy `ROOT.war` into `tomcat/webapps/`.
 
-7. Next, open a web browser to localhost:8080/lucee/admin/web.cfm. You should see the Lucee Web admin login screen. Lucee is now installed.
+1. Create a `startup.sh` file in the `tomcat/` directory with the following contents, replacing `<username>` with your macOS username:
 
-8. You may want to install [mod_cfml](https://viviotech.github.io/mod_cfml/install-lin-ubuntu.html) to use Apache
+```bash
+#!/bin/bash
+# set the path to Tomcat binaries
+export CATALINA_HOME=/Users/<username>/tomcat
 
-**Next Steps**
+# set the path to the instance config
+export CATALINA_BASE=/Users/<username>/tomcat
+
+EXECUTABLE=${CATALINA_HOME}/bin/catalina.sh
+exec $EXECUTABLE run
+```
+
+1. Make the script executable and start Tomcat:
+
+```bash
+chmod +x startup.sh
+./startup.sh
+```
+
+1. Open a web browser to `http://localhost:8080/lucee/admin/server.cfm`. You should see the Lucee Server Admin login screen. On first access, you'll be prompted to set an admin password.
+
+## Understanding Lucee's Directory Structure
+
+When Lucee starts, it creates configuration directories:
+
+- **Server config**: `tomcat/webapps/ROOT/WEB-INF/lucee-server/` - Contains server-wide settings
+- **Web config**: `tomcat/webapps/ROOT/WEB-INF/lucee/` - Contains web context settings
+- **Config file**: `.CFConfig.json` in the `context/` subdirectory stores your configuration
+
+## Optional: Apache Integration
+
+You may want to install [mod_cfml](https://viviotech.github.io/mod_cfml/) to integrate with the Apache web server.
+
+## Next Steps
 
 From this point you can configure your Tomcat instance and set up your applications in Lucee.