Guides › LanguageTool
Your own LanguageTool checker
LanguageTool, the checker Novelar uses, is open source: you can run it on your own computer. The paragraphs checked as you write then never leave your machine, and the checker works offline.
Before you start
- About 15 minutes, and around 1 GB of free memory while the server is running.
- The same rules as the free service. Your own server doesn't include LanguageTool Premium's extra rules.
- Pick one of the three ways to install it. If you already use Docker, it's the simplest; on a Mac, Homebrew is just as easy.
1. Install and start the server
With Docker Desktop (Mac and Windows) or Docker (Linux) running, one command in a terminal:
docker run -d --name languagetool --restart unless-stopped -p 127.0.0.1:8010:8010 -e Java_Xmx=1g erikvl87/languagetool
It uses the community image erikvl87/languagetool, the most widely used one.
127.0.0.1 means only your computer can connect, and --restart unless-stopped starts it
again whenever Docker opens.
Server address: http://localhost:8010
With Homebrew installed, in a terminal:
brew install languagetool
brew services start languagetoolHomebrew installs Java too, and the server starts by itself every time you log in. It only accepts connections from your own computer.
Server address: http://localhost:8081 (Homebrew uses port 8081).
For any system, without Docker or Homebrew. You need Java 17 or later (for example, the free Temurin).
- Download the latest
LanguageTool-*.zipfrom languagetool.org/download and unzip it. -
Open a terminal (PowerShell on Windows) in the unzipped folder and start the server:
java -cp languagetool-server.jar org.languagetool.server.HTTPServer --port 8010
The server runs while that terminal window stays open, and only accepts connections from your own computer.
Server address: http://localhost:8010
To check it's running, open the server address followed by /v2/languages in your browser (for
example, http://localhost:8010/v2/languages). If you see a list of languages, it works. The first
start can take a minute.
2. Connect it in Novelar
- Open Settings (⌘ , on a Mac, Ctrl , on Windows and Linux) and go to Services → Checker.
-
Choose Your own server. The Server address is already filled in
(
http://localhost:8010); if you installed it with Homebrew, change it tohttp://localhost:8081. - Press Test connection. It should say Connected.
- Press Use this one. From now on it shows as In use.
To try it, misspell a word, such as “recieve”: the underline now comes from your own computer.
If something doesn't work
-
“The checker isn't responding”. The server isn't running. With Docker, open Docker Desktop (or
run
docker start languagetool); with Homebrew,brew services restart languagetool; with Java, run the command again and keep the terminal open. -
Test connection fails with Homebrew. Check that the address ends in
:8081, not:8010. -
The checker is slow or stops on long chapters. Give it more memory: with Docker, change
Java_Xmx=1gtoJava_Xmx=2g(remove the container withdocker rm -f languagetooland create it again).
To go back to the free service
In Settings → Services → Checker, choose Free LanguageTool and press
Use this one. You can then stop the server (docker rm -f languagetool or
brew services stop languagetool).
Want the AI review's text to stay on your computer too? Follow the LM Studio guide.