Spring Boot Project - Spring Petclinic | GitHub

In this post, we would like to suggest a free open-source project that is Spring Petclinic developed using Spring Boot for learning purposes. So go ahead, check out the source code, and have a hands-on experience on real-time project.

Spring Petclinic project is an open-source and available on GitHub repository - https://github.com/RameshMF/spring-petclinic

Spring Boot Project - Spring Pet clinic

This is a sample Spring Petclinic application developed by the Spring team to demonstrates the Spring framework related features.

Running petclinic locally

Petclinic is a https://spring.io/guides/gs/spring-boot[Spring Boot] application built using https://spring.io/guides/gs/maven/[Maven]. You can build a jar file and run it from the command line:

git clone https://github.com/spring-projects/spring-petclinic.git
cd spring-petclinic
./mvnw package
java -jar target/*.jar

You can then access petclinic here: http://localhost:8080/

Database configuration

In its default configuration, Petclinic uses an in-memory database (HSQLDB) which gets populated at startup with data. A similar setup is provided for MySql in case a persistent database configuration is needed. Note that whenever the database type is changed, the app needs to be run with a different profile: spring.profiles.active=mysql for MySql.

You could start MySql locally with whatever installer works for your OS, or with docker:

docker run -e MYSQL_ROOT_PASSWORD=petclinic -e MYSQL_DATABASE=petclinic -p 3306:3306 mysql:5.7.8

Working with Petclinic in your IDE


The following items should be installed in your system:


  1. On the command line
git clone https://github.com/spring-projects/spring-petclinic.git
  1. Inside Eclipse or STS
File -> Import -> Maven -> Existing Maven project

Then either build on the command line ./mvnw generate-resources or using the Eclipse launcher (right-click on project and Run As -> Maven install) to generate the css. Run the application main method by right-clicking on it and choosing Run As -> Java Application.

  1. Inside IntelliJ IDEA

In the main menu, choose File -> Open and select the Petclinic pom.xml. Click on the Open button.

CSS files are generated from the Maven build. You can either build them on the command line ./mvnw generate-resources or right-click on the spring-petclinic project then Maven -> Generates sources and Update Folders.

A run configuration named PetClinicApplication should have been created for you if you're using a recent Ultimate version. Otherwise, run the application by right-clicking on the PetClinicApplication main class and choosing Run 'PetClinicApplication'.

  1. Navigate to Petclinic

Visit http://localhost:8080 in your browser.

The below screen screenshot shows a demo of this application:

You can clone the PetClinic application from GitHub - https://github.com/RameshMF/spring-petclinic.
Check out readme to know more about the PetClinic application.