Skip to content

Install lueur

lueur strives to get of your way and it starts with a smooth installation.

Download lueur

lueur is provided as a binary targetting the three major platforms: Linux, macOS and Windows.

You may try the installation script:

curl -sSL https://lueur.dev/get | bash

Alternatively, you can download the appropriate binary for your platform from here.

Configure the binary

Once you have downloaded the archive, you can uncompress it and make sure it can be found in your PATH.

export PATH=$PATH:`pwd`

Make also sure the downloaded binary is an executable:

chmod a+x lueur

$env:Path += ';C:\directoy\where\lueur\lives'

Do you want to know more?

Find more installation options here.

Check lueur is ready to roll

Let's verify it all went well by running the following command:

lueur --help

This should output the following:

A proxy to test network resilience by injecting various faults.

Usage: lueur [OPTIONS] <COMMAND>

Commands:
  run       Run the lueur proxy and apply network faults to traffic
  scenario  Execute a scenario
  demo      Run a simple demo server for learning purpose
  help      Print this message or the help of the given subcommand(s)

Options:
      --log-file <LOG_FILE>    Path to the log file. Disabled by default
      --log-stdout             Stdout logging enabled
      --log-level <LOG_LEVEL>  Log level [default: info,tower_http=debug]
      --with-otel              Enable open telemetry
  -h, --help                   Print help
  -V, --version                Print version

Troubleshooting

If you receive a message such as ̀lueur: No such file or directory, it likely means you have not put the directory containing the lueur binary in your PATH, or you may need to restart your session for the changes to take effect.

Next Steps

You’ve successfully downloaded and made lueure. What’s next?

  • Explore our Getting Started Tutorial to learn how to first use lueur.
  • Dive into How-To Guides to integrate lueur deeper into your workflow, from automated testing to continuous integration.