Administrator Manual

This manual describes the administration steps, if you want to install Peep on your own machines.

Architecture

Before starting with the deployment of the application, it is a good idea to take a look at the Architecture Manual first.

Requirements

Peep does require Bash on a Linux or MacOS system. Also, you need some common GNU tools like dateor hostname which will be present automatically. You also need a compatible Nerd Font to use the icons feature. Yet, you can replace the icons with other things.

Deploy

This section describes the necessary steps to deploy the software.

Install script

The install script is the most convenient way installing Peep on your machine. You can run it directly from the web:

TODO: enter proper URLs

# Install for the current user only
$ curl -sfL https://gitlab.com/cozybadgerde/applications/peep/-/raw/trunk/deployments/install.sh?ref_type=heads | bash -

# Install for all users of the system
$ curl -sfL https://gitlab.com/cozybadgerde/applications/peep/-/raw/trunk/deployments/install.sh?ref_type=heads | sudo bash -

Or download it and execute the installer locally.

$ curl -sfL https://gitlab.com/cozybadgerde/applications/peep/-/raw/trunk/deployments/install.sh?ref_type=heads -o peep_install.sh
# Now you can review the script and execute it afterward
# Install for the current user only
$ ./peep_install.sh

# Install for all users of the system
$ sudo ./peep_install.sh

Manual Setup

TODO: enter proper URLs

If you don't like the script or if it doesn't work for you, you can also perform a manual installation. This is also the way, if you want to pick the desired commit directly from a development branch. To do, you need to download the desired release package from the releases page.

After doing so, you need to unpack the release:

TODO: enter proper URLs

tar -xvf

Hop into the unpacked directory:

cd

And copy Peep to your desired location:

# Install for the current user only
$ mkdir -p ~/.local/bin/
$ cp src/peep.sh ~/.local/bin/peep
$ chmod 755 ~/.local/bin/peep

# Install for all users of the system
$ sudo mkdir -p /usr/local/bin/
$ sudo cp src/peep.sh /usr/local/bin/peep
$ sudo chmod 755 /usr/local/bin/peep

Optionally, you can also copy the default configuration and tweak it afterwards:

# Install for the current user only
$ mkdir -p ~/.config/peep/
$ cp src/peep.cfg ~/.config/peep/peep.cfg
$ chmod 644 ~/.config/peep/peep.cfg

# Install for all users of the system
$ sudo mkdir -p /etc/peep/
$ sudo cp src/peep.cfg /etc/peep/peep.cfg
$ sudo chmod 644 /etc/peep/peep.cfg

Next steps

Now, that you have a running setup, you can check out the User Manual and do some configurations.