Need help with castlemock?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

190 Stars 62 Forks Other 1.1K Commits 62 Opened issues


Castle Mock is a web application that provides the functionality to mock out RESTful APIs and SOAP web services.

Services available


Need anything else?

Contributors list

Castle Mock:
Mock RESTful APIs and SOAP web services

Castle Mock is a web application that provides the functionality to mock out RESTful APIs and SOAP web services. This functionality allows client-side developers to completely mimic a server side behaviour and shape the responses themselves.

Table Of Content


Castle Mock can create mocked services based on WSDL, WADL, Swagger and RAML definition files. The web-services defined within the files will be mocked automatically by Castle Mock. Once the mocks for the web-services are created, they can be configured to mock the service or forward the request to the original endpoint. The response from the forwarded requests can be recorded automatically and used to create new mocked responses.

Castle Mock is completely free and open source (Apache License). It is built with Java and the application itself is deployed to an Apache Tomcat server.

What to Use Castle Mock for and When to Use It

Use Castle Mock to mock out RESTful APIs and SOAP web services for testing purposes for when either performing system or integration tests. It is recommended to only use Castle Mock on an internal network and never be used publically. Castle Mock is NOT developed or meant for anything else other than for testing purposes.


Non-source downloads such as WAR files can be found on our website: The WAR files can also be located and downloaded from GitHub Releases.


Castle Mock can be downloaded as Java Web Archive (.war) file and be deployed on a Apache Tomcat server (Java 11+ and Apache Tomcat 8.5 or 9). Castle Mock can also be deployed by using Docker. For more information go to the offical Castle Mock Docker page:

Upon successful installation and deployment, Castle Mock can be accessed from the web browser:


This will prompt you the login screen. When logging for the first time use the following credentials:

Username: admin 
Password: admin 

It is recommended that the administrator profile gets updated with a more secure password. This is accomplish by going to the user page and choosing to update the profile.

Upon successful login, you will be able to create both SOAP and REST projects. SOAP and REST resources can either be created manually or created by importing resource descriptions, such as WSDL and WADL. All created resources can be mocked multiple times. Each resource can also be configured to have different response strategies, such as random and sequence


Docker is an open-source project that automates the deployment of applications inside software containers, by providing an additional layer of abstraction and automation of operating-system-level virtualization on Linux.

Castle Mock absolutely loves Docker. Docker allows you to simply setup and deploy your own instance of Castle Mock, by just typing one line. Download and install Docker by visiting their web page:

Use our official Docker image to setup and test Castle Mock:

docker run -d -p 8080:8080 castlemock/castlemock

Castle Mock can be accessed from the following address after the installation is finished:

http://{CONTAINER IP}:8080/castlemock

For more information and details:


Documentation can be found under our GitHub Wiki.


Bugs and Feedback

For bugs, questions and discussions please use the GitHub Issues. Please read our FAQ and Code Of Conduct before creating a new issue.

Continuous integration

Castle Mock's continuous integration environment is publicly available and can be access on the following link: Travis CI

News and Website

All information about Castle Mock can be found on our website. Follow us on Twitter: CastleMock.


Castle Mock is licensed under the Apache License. The terms of the license are as follows:

Apache License

Copyright 2015 Karl Dahlgren and a number of other contributors.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.