This repository contains smeagol, an wiki server which stores its files in a git repository.
Note: If you intend to use your local ecosystem, which will also reside on
192.168.56.2by default, you have to set an etcd key first. This can be done in vagrant with the command
etcdctl set /config/_global/stage "development"and restarting CAS in vagrant via
docker restart cas.
Setting up a development ecosystem via groovy
Smeagol requires a proper configured Cloudogu EcoSystem in order to work properly. This can be achieved by using the provided groovy execution:
This command will clone the ecosystem repository into the
.workspace folder, creates a
setup.json with a proper
configuration and starts the vm. After the vm has started, open the setup in your browser at
http://192.168.56.2:8080, register the instance and finish the setup.
Then you can access SCM-Manager at:
With those credentials you can also enter the VM via SSH:
cd .workspace/ecosystem; vagrant ssh
Hint: Make sure your SCM-Manager has the Smeagol Plugin installed!
To stop the vm use the down execution:
If the vm is not longer required, it can be removed with the destroy execution:
The server for the REST API can be started with the run goal of the spring-boot maven plugin:
./mvnw clean spring-boot:run
To access the development instance open
http://192.168.56.1:8080 in your browser.
For example, you can get all repositories from
Make sure your SCM-Manager has the Smeagol Plugin installed!
If Smeagol runs on your local host and you use CAS and SCM-Manger inside a CES instance please make sure the SCM-Manager CAS setting accepts any proxy like so:
- Administration -> Settings -> CAS -> Accept any proxy (enabled)
To start the UI development server, you should use yarn. First install the required dependencies:
After the dependency installation has finished, start the development server:
yarn run start
After the RESTApi and the UI are successfully started, we can open Smeagol in our browser at
The spring-boot server from the RESTApi will proxy every ui request to the UI server.
Hot reload should work out of the box for the ui.
To enable hot reload for java classes, the application must be started with the maven goal "spring-boot:run". For Intellij we have to recompile the project or enable "Make project automatically", but this requires some sort of hack. Please have a look at the description of the issue IDEA-141638.
What is the Cloudogu EcoSystem?
The Cloudogu EcoSystem is an open platform, which lets you choose how and where your team creates great software. Each service or tool is delivered as a Dogu, a Docker container. Each Dogu can easily be integrated in your environment just by pulling it from our registry. We have a growing number of ready-to-use Dogus, e.g. SCM-Manager, Jenkins, Nexus, SonarQube, Redmine and many more. Every Dogu can be tailored to your specific needs. Take advantage of a central authentication service, a dynamic navigation, that lets you easily switch between the web UIs and a smart configuration magic, which automatically detects and responds to dependencies between Dogus. The Cloudogu EcoSystem is open source and it runs either on-premises or in the cloud. The Cloudogu EcoSystem is developed by Cloudogu GmbH under MIT License.
How to get in touch?
Want to talk to the Cloudogu team? Need help or support? There are several ways to get in touch with us:
© 2020 Cloudogu GmbH - MADE WITH