LibreQoE

Readme:

  • Sponsors
  • Support LibreQoS
  • Documentation
  • Matrix Chat
  • Features

Read me first!

  • Network Design Assumptions

Change Notes:

  • LibreQoS v1.3.1 to v1.4 Change Summary

Quickstart:

  • System Requirements
  • Network Interface Requirements
  • Server Setup - Pre-requisites
  • Install LibreQoS 1.4
  • Configure LibreQoS
  • LibreQoS daemons
  • Share your before and after

Updates:

  • Updating 1.4 To Latest Version

Technical Documentation:

  • Complex install (Not Recommended)
    • Clone the repo
    • Install Dependencies from apt and pip
    • Install the Rust development system
  • Troubleshooting
  • Integrations
  • Extras
  • Performance Tuning

Legacy:

  • LibreQoS v1.3.1
LibreQoE
  • Complex install (Not Recommended)
  • View page source

Complex install (Not Recommended)

Clone the repo

The recommended install location is /opt/libreqos Go to the install location, and clone the repo:

cd /opt/
git clone https://github.com/LibreQoE/LibreQoS.git libreqos
sudo chown -R YOUR_USER /opt/libreqos

By specifying libreqos at the end, git will ensure the folder name is lowercase.

Install Dependencies from apt and pip

You need to have a few packages from apt installed:

sudo apt-get install -y python3-pip clang gcc gcc-multilib llvm libelf-dev git nano graphviz curl screen llvm pkg-config linux-tools-common linux-tools-`uname -r` libbpf-dev

Then you need to install some Python dependencies:

cd /opt/libreqos
python3 -m pip install -r requirements.txt
sudo python3 -m pip install -r requirements.txt

Install the Rust development system

Go to RustUp and follow the instructions. Basically, run the following:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

When Rust finishes installing, it will tell you to execute a command to place the Rust build tools into your path. You need to either execute this command or logout and back in again.

Once that’s done, please run:

cd /opt/libreqos/src/
./build_rust.sh

This will take a while the first time, but it puts everything in the right place.

Now, to build rust crates, run:

cd rust
cargo build --all
Previous Next

© Copyright 2023, LibreQoE.

Built with Sphinx using a theme provided by Read the Docs.