Awesome Open Source
Awesome Open Source

Spring Boot Blog Demo


This is a demo project for practicing Spring Boot + Thymeleaf. The idea was to build some basic blogging platform.

It was made using Spring Boot, Spring Security, Thymeleaf, Spring Data JPA, Spring Data REST and Docker. Database is in memory H2.

There is a login and registration functionality included.

User has his own blog page, where he can add new blog posts. Every authenticated user can comment on posts made by other users. Home page is paginated list of all posts. Non-authenticated users can see all blog posts, but cannot add new posts or comment.

Screenshot 1

Screenshot 1


Configuration Files

Folder src/resources/ contains config files for blog-demo Spring Boot application.

  • src/resources/ - main configuration file. Here it is possible to change admin username/password, as well as change the port number.

How to run

There are several ways to run the application. You can run it from the command line with included Maven Wrapper, Maven or Docker.

Once the app starts, go to the web browser and visit http://localhost:8090/home

Admin username: admin

Admin password: admin

User username: user

User password: password

Maven Wrapper

Using the Maven Plugin

Go to the root folder of the application and type:

$ chmod +x scripts/mvnw
$ scripts/mvnw spring-boot:run

Using Executable Jar

Or you can build the JAR file with

$ scripts/mvnw clean package

Then you can run the JAR file:

$ java -jar target/blog-demo-0.0.1-SNAPSHOT.jar


Open a terminal and run the following commands to ensure that you have valid versions of Java and Maven installed:

$ java -version
java version "1.8.0_102"
Java(TM) SE Runtime Environment (build 1.8.0_102-b14)
Java HotSpot(TM) 64-Bit Server VM (build 25.102-b14, mixed mode)
$ mvn -v
Apache Maven 3.3.9 (bb52d8502b132ec0a5a3f4c09453c07478323dc5; 2015-11-10T16:41:47+00:00)
Maven home: /usr/local/Cellar/maven/3.3.9/libexec
Java version: 1.8.0_102, vendor: Oracle Corporation

Using the Maven Plugin

The Spring Boot Maven plugin includes a run goal that can be used to quickly compile and run your application. Applications run in an exploded form, as they do in your IDE. The following example shows a typical Maven command to run a Spring Boot application:

$ mvn spring-boot:run

Using Executable Jar

To create an executable jar run:

$ mvn clean package

To run that application, use the java -jar command, as follows:

$ java -jar target/blog-demo-0.0.1-SNAPSHOT.jar

To exit the application, press ctrl-c.


It is possible to run blog-demo using Docker:

Build Docker image:

$ mvn clean package
$ docker build -t blog-demo:dev -f docker/Dockerfile .

Run Docker container:

$ docker run --rm -i -p 8090:8090 \
      --name blog-demo \
Helper script

It is possible to run all of the above with helper script:

$ chmod +x scripts/
$ scripts/


Folder docker contains:

  • docker/blog-demo/Dockerfile - Docker build file for executing blog-demo Docker image. Instructions to build artifacts, copy build artifacts to docker image and then run app on proper port with proper configuration file.

Util Scripts

  • scripts/ - util script for running blog-demo Docker container using docker/Dockerfile


Tests can be run by executing following command from the root of the project:

$ mvn test

Helper Tools

HAL REST Browser

Go to the web browser and visit http://localhost:8090/

You will need to be authenticated to be able to see this page.

H2 Database web interface

Go to the web browser and visit http://localhost:8090/h2-console

In field JDBC URL put


In /src/main/resources/ file it is possible to change both web interface url path, as well as the datasource url.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Java (705,863
Shell (230,877
Docker (33,372
Spring Boot (12,138
Spring Boot (12,138
Blog (8,716
Bash (6,875
Spring (4,921
Java 8 (3,623
Shell Script (2,305
Spring Mvc (1,851
Bash Script (1,835
Spring Security (1,520
Spring Data Jpa (1,011
Thymeleaf (680
H2 Database (335
H2 (146
Related Projects