Getting started
This guide will help you start with Lygeum. it covers installing and booting the server in test mode as well as configuring a first environment and application and downloading the associated configuration
1. Download & Install
Running lygeum is very simple, you can either download the fat jar and run it or boot the docker official image.
go to download page and download the lygeum server based on your desired installation type.
2. Start lygeum server
For this tutorial Lygeum will run in test mode with an embedded database if you want to run Lygeum in production check out the detailed installation instructions
- Fat jar
java -jar lygeum-server-<version>.jar
- Docker
docker run -itd --name lygeum -p 5000:5000 kaiso/lygeum:latest
3. Open http://localhost:5000 in your favorite browser and login with the default credentials:
- user:
lygeum
- password:
lygeum
(It is recommanded to change the default password in non test deployment)
4. Set up your first configuration
After you have logged in:
- Select
Configurations
from the left side bar - Go to
Environments
and click on theAdd
button to add an environment, type the name and clicksave
- Back to
Configurations
and selectApplications
- Click
Add
button to add an application, type the name and clicksave
- Back to
Configurations
and selectProperties
- Select the environment from the dropdown and type the name of the application in the application field
- Click
Add
button to add a property, type the name and the value andsave
Now you have created your first configuration environment and application
5. Use your configuration through the Lygeum CLI
In order to configure the Lygeum Command Line Interface, first make sure you have Python 3.5 or above installed.
- install the Lygeum CLI via the following command:
pip3 install lygeumcli
- Now you have to add a client to access the configuration created before so go to the Lygeum console again and browse to
Administration > Clients
- Create a new client by giving a name and then save
- Copy the Client ID and the Client Secret we will use them in the next step.
- Configure the Lygeum CLI by running:
lygeum configure
-
answer the questions by providing the client id, the client secret and the server url
(the url in our case it ishttp://localhost:5000
if you are running the CLI on the same machine) - Use the lygeum CLI to download your configuration by running:
lygeum properties download -e <the env> -a <the app> -l <layout> -f <the path to the file>
- The
layout
may bejson
,properties
oryaml
- Example:
lygeum properties download -e my-env -a my-app -l json -f /tmp/my-config.json
- The
Congratulations you have achieved your first Lygeum centralized configuration
- Previous
- Next