A small simple HTTP chat server. made for use in school where all messengers are blocked.
This project is a lightweight Java HTTP server that serves a chat UI and provides simple REST endpoints for creating users and sending/receiving messages. Source is under src/main/java and static UI files are under src/main/resources/html.
- Java 17+ (or the version configured in
build.gradle) - Git (optional)
- Gradle wrapper included (
./gradlew)
From the repository root run:
./gradlew clean ShadowJarThis produces artifacts under build/libs/.
./gradlew ShadowJar
java -jar build/libs/school_chat_server_java-0.1-all.jar If the project produces a fat/shadow jar.
- Server config stored in
school_chat_server_java/src/main/java/school/chat/core/Config.java - Stored runtime data (users, messages, verification text): the
server_data/directory contains JSON files such asusers.json,chat_messages.json, andverification_text.json.
Modify those files or the server source if you need different default data.
The server runs over plain HTTP only. There is no built-in TLS configuration, and no keystore setup is required.
- Review
src/main/java/school/chat/Main.javaif you need to change the server port or add extra Javalin configuration.
- Install Java 17+
- Build:
./gradlew clean ShadowJar - Run:
java -jar build/libs/*.jar