Webswing Installation Guide
Install Webswing from the distribution package and provide a supported Java runtime for the server. Additional requirements depend on the application runtime. For native Linux desktop applications, install Linux Web Launcher (LWL) on the session host and provide the Linux application executable and its dependencies. Check the LWL host requirements before deployment.
Supported Java versions for starting the server are:
- All recent major distributions compliant with the LTS Java SE 25, 21, 17, 11 or 8 standards (1.8.0_202‑b08 or newer)
- Adoptium, Amazon Corretto, Red Hat JDK, IBM SDK, Oracle JDK
Installation topics
- Hardware Requirements — sizing guidelines and capacity planning for different workloads
- Starting on Windows — running Webswing on Windows and installing it as a service
- Starting on Linux — launch scripts, important files, systemd service and XHeadless notes
- Docker — building and running Webswing in a container, with Dockerfile & Compose examples
- Startup Options — command‑line arguments and server/property files explained
- Logging Configuration — configuring Log4j 2 output, rotation, compression, and retention
- SSL Configuration — enabling HTTPS in embedded Jetty or via a reverse proxy
- Tomcat Deployment — deploying Webswing into an external Apache Tomcat servlet container
- IBM WAS 9.0 Deployment — deploying Webswing on IBM WebSphere Application Server 9.0
- Reverse Proxy — using Apache HTTPD, NGINX, IIS or Envoy as a reverse proxy (incl. load balancing)
- Linux Web Launcher — setting up the optional runtime for running Linux desktop applications