ManualWorks is a server application developed in Java. After you install it, users access it with a web browser, so it is web-based software. Users do not need to install any software. However, the server that runs ManualWorks needs the hardware and software described in this chapter.

All requirements in this chapter are minimum requirements.

System Architecture

Note the following.

ManualWorks supports the LTS (Long Term Support) versions of Java: 8, 11, 17, 21, and 25.
- H2, the default database, requires Java 11 or later. You can use Java 8 only with Oracle Java 8 and a database other than H2, such as Apache Derby.
- Both Oracle Java and OpenJDK are supported. OpenJDK must be version 11.0.1 or later. If you start ManualWorks with an earlier version, such as OpenJDK 8, ManualWorks shows an error page for every request.
- We recommend Java 25.
You do not need to install Apache Tomcat separately. It is built into ManualWorks.
If you use H2 as the database, you do not need to install it separately. H2 is built into ManualWorks. You can also use Oracle, Microsoft SQL Server, or MySQL.
We recommend keeping the storage disk and the backup disk physically separate.
- Uploaded files are copied to the backup disk in real time. With H2, the transaction log is saved to the backup disk in real time, and the database is copied to the backup disk once a day.
Any web server that can work with Apache Tomcat is supported. You can also use ManualWorks without a web server.

3Rabbitz does not support installing or operating web servers or Java. If you use a database other than H2, 3Rabbitz does not support installing or operating that database either.

Starting with ManualWorks 6.0.14, ManualWorks uses H2 instead of Apache Derby. For the background, see this blog post (in Korean). H2 requires Java 11 or later, so you can no longer use Java 8 with H2. If you use another database, you can keep using Oracle Java 8. OpenJDK must be version 11.0.1 or later.

However, we recommend Java 25.

Software Requirements

Web Browsers

All ManualWorks features are supported only in Google Chrome and Microsoft Edge. For details on browser support, see Web Browsers.

Microsoft Internet Explorer 11 is no longer supported.

Server Software

Operating Systems

ManualWorks supports any operating system that can run Java.

Java

To run ManualWorks, you must install Java on the operating system. We recommend Java 25. Both Oracle Java and OpenJDK are supported. OpenJDK must be version 11.0.1 or later.

In line with the Oracle Java license, ManualWorks supports the LTS (Long Term Support) versions 8, 11, 17, 21, and 25. For stability and performance, however, we recommend Java 25.

Starting with ManualWorks 7.0 (planned for January 2027), Java 25 will be the minimum requirement.

Hardware Requirements

Install ManualWorks on a server with at least a 2 GHz CPU, 4 GB of RAM, and 300 GB of disk space. In general, we recommend the following.

CPU: We recommend a 4-core CPU. ManualWorks spends most of its time on I/O. Search runs in parallel, but 4 cores are enough for most workloads.
Memory: If you have many users who edit actively, we recommend setting the maximum Java heap size to 6 GB, and 8 GB of RAM to support it. The default maximum Java heap size in the startup script is 2048 MB (-Xmx2048m). To change it, see Changing the Java Heap Size.
Database (files): The size of the database and files depends on the number of documents and edits. At first, the minimum of 300 GB is enough. Add more as usage grows.
Separate storage device: You need a separate storage device to back up data and uploaded images and files.

Hardware requirements depend on the 문서 수와 사용자 수. For testing, you can also install ManualWorks on a personal computer.

Ports and Firewalls

ManualWorks uses the following ports.

1975: The HTTP port that web browsers connect to.
5791: The port used to shut down ManualWorks. It is used only within the server.

To access ManualWorks from other computers, allow inbound connections on port 1975 (TCP) in the server firewall. Do not open port 5791 to the outside. To change the port numbers, see Changing Port Numbers.

On Windows, add an inbound rule that allows port 1975 (TCP) in the advanced settings of Windows Defender Firewall. On Linux with firewalld, allow the port with the following commands.

sudo firewall-cmd --permanent --add-port=1975/tcp
sudo firewall-cmd --reload

On Linux with ufw, allow the port with the following command.

sudo ufw allow 1975/tcp