Peekl

Appearance

Setting up the server ​

The server is the component that all the agents will interact with. This is the one responsible for fetching the correct code that apply to the agent that contacted him.

Installing using packages ​

By default the certificate generated by the server during it's bootstrap will only contains peekl as the domain name. If you want to use a custom domain name, such as example.peekl.dev, you should add a configuration file at path /etc/peekl/config/server.yml with the following content.

yaml
certificates:
  bootstrap_dns_names:
    - 'example.peekl.dev'

Then you can proceed by downloading the package from Github, and install it.

bash
export PEEKL_VERSION=0.1.0
export PEEKL_ARCH=amd64
wget https://github.com/peeklapp/peekl/releases/download/${PEEKL_VERSION}/peekl-server_${PEEKL_VERSION}_linux_${PEEKL_ARCH}.deb
apt install ./peekl-server_${PEEKL_VERTSION}_linux_${PEEKL_ARCH}.deb

The server should automatically start, bootstrap himself, and be ready to receive queries. You can validate that everything is working correctly using the following command.

bash
systemctl status peekl-server.service

By default, and for security purpose, Peekl will only listen on host 127.0.0.1 and port 9040. You can change this behavior by adding the following configuration to the configuration file.

yaml
listen:
  host: 0.0.0.0
  port: 9040