Quick Start

Download Vigie and run tests

Standalone Vigie

This step by step quickstart will run Vigie in its simplest operating mode : Standalone. More advanced and automated deployments are available in Vincoll/vigie-deploy

Get Vigie

Download the binary

Vigie is a single binary with no dependencies.

wget https://github.com/Vincoll/vigie/releases/download/v0.8.0/vigie_v0.8.0_linux_amd64.tar.gz && \
tar -xzvf vigie_v0.8.0_linux_amd64.tar.gz
wget "https://github.com/Vincoll/vigie/releases/download/v0.8.0/vigie_v0.8.0_linux_amd64.zip" -outfile "vigie_v0.8.0_linux_amd64.zip"
docker pull vincoll/vigie:0.8.0

Get a Vigie configuration file

Grab a pre-configure Vigie Config, ready to run.

Vigie tests auto-provisioning

Tests will be downloaded by Vigie from the vigie-demo-test git repo.

wget -O vigieconf_standalone.toml https://raw.githubusercontent.com/Vincoll/vigie-demo-test/master/vigieconf_standalone.toml
wget https://raw.githubusercontent.com/Vincoll/vigie-demo-test/master/vigieconf_standalone.toml -outfile "vigieconf_standalone.toml"
wget -O vigieconf_standalone.toml https://raw.githubusercontent.com/Vincoll/vigie-demo-test/master/vigieconf_standalone.toml

Edit VigieConf (optional)

You can quickly edit the config to configure the alerting, or change the API port if you wish.

Run Vigie

Adding capacity to Vigie is mandatory in order to send icmp requests.

chmod +x ./vigie && \
sudo setcap cap_net_raw,cap_net_bind_service=+ep ./vigie && \
vigie run --config vigieconf_standalone.toml
vigie run --config vigieconf_standalone.toml
docker run \
-v $(pwd)/vigieconf_standalone.toml:/app/config/vigie.toml \
--name vigie-demo \
-p 6680:80
vincoll/vigie:0.8.0

Access the API

No WebUI yet :/

Go to http://localhost:6680/api/testsuites/all

This Vigie deployment (Standalone) does not require any other software to rely on.
Other Vigie's deployment type (Complete) allow you to store your results into a Database and graph the results.