Skip to main content

How to start a web server using Java

·433 words·3 mins
Alejandro Duarte
Alejandro Duarte
Alejandro Duarte is a Software Engineer, published author, and award winner. He currently works for MariaDB plc as a Developer Relations Engineer. Starting his coding journey at 13 with BASIC on a rudimentary black screen, Alejandro quickly transitioned to C, C++, and Java during his academic years at the National University of Colombia. Relocating first to the UK and then to Finland, Alejandro deepened his involvement in the open-source community. He’s a recognized figure in Java circles, credited with articles and videos amassing millions of views, and presentations at international events.

Do you want to start a basic HTTP server to serve the files in a directory on your machine using Java? If so, here’s how.

Available since Java 18

A simple web server is available since Java 18. Install your favorite distribution of JDK 18 or later. If you don’t have a favorite one, I recommend Eclipse Temurin (18 will be available shortly after this blog post publishing date). I also recommend using SDKMAN! if you are on Linux-like operating systems. It just makes it much easier to manage multiple versions of JDK on the same machine. For example, to try Java 18 on the same day the reference implementation was released, I just run the following:

$ sdk install java 18-open

You can install other distributions as well. See the available options running:

$ sdk list java

Check that the correct version of the JDK is installed and in use:

$ java --version

You should see something like the following:

openjdk 18 2022-03-22
OpenJDK Runtime Environment (build 18+36-2087)
OpenJDK 64-Bit Server VM (build 18+36-2087, mixed mode, sharing)

Creating an example HTML file

Create a new directory to host the files you want to serve. Here’s how to do so using Linux/macOS:

$ mkdir web-content

Inside this directory, create a new index.html file with the following content:

<!DOCTYPE html>
<html lang="en">
        <meta charset="utf-8">
        <title>Java's HTTP server</title>
        <h1>Hi! 👋</h1>
            This content was served by Java's simple
            HTTP server.

Tip: if you are on macOS, you can copy the previous snippet of code and create the file with the copied text using the following command: pbpaste > index.html.

Starting the server

Start the HTTP web server:

$ jwebserver

Point your browser to  http://localhost:8000 and see the HTML file rendered:

By default, the server serves the files in the current directory using port 8000. You can override the defaults as follows:

$ jwebserver -d /path/to/some/directory/ -p 9999

This will serve the files in /path/to/some/directory/ at  http://localhost:9999. Make sure to use an absolute path, otherwise, you’ll get an error.

Alternatively, you can run the server using the java command:

$ java -m jdk.httpserver

To stop the server, press CTRL+C in the terminal.


At the time of writing this, Java’s simple HTTP web server has some limitations:

  • HTTPS is not supported
  • HTTP2 is not supported (only HTTP 1.1)
  • Only the GET and HEAD HTTP request methods are supported

See JEP 408: Simple Web Server for more information.

If you liked this post, consider  following me on Twitter and subscribing to  Programming Brain on Youtube. Happy coding!


What is JPA?
·364 words·2 mins
Programming Databases
JPA stands for Jakarta Persistence API (previously, Java Persistence API). It’s an API specification for database connectivity in Java applications.
What is a database connection pool?
·258 words·2 mins
Programming Databases
A database connection pool stores ready-to-use database connections that threads can borrow when they need them, and return when they finish the work with the database.
How to execute SQL queries from Java (and prevent SQL injections)
·231 words·2 mins
Programming Databases
To run SQL queries in Java, you need a Connection object.