Requires Python 3.8 or higher (3.10 prefered), expects Ubuntu 22.04 or more recent.
Poetry is tool to handle dependency installation as well as building and packaging of Python packages.
curl -sSL https://install.python-poetry.org | python3 -
More details in the the installation guide.
Redis: An open source (BSD licensed), in-memory data structure store, used as a database, cache and message broker.
|Redis should be installed from the source, and the repository must be in the same directory as the one you will be cloning Lookyloo in to.
|Since Lookyloo 1.15, redis 7.0 is required.
In order to compile and test redis, you will need a few packages:
sudo apt-get update
sudo apt install build-essential tcl
git clone https://github.com/redis/redis.git
git checkout 7.2
# Optionally, you can run the tests:
Poetry is installed.
Redis is installed from the source. The repository must be in the same directory as the one you will be cloning Lookyloo in to.
Python3 development package
sudo apt install python3-dev
Clone the Lookyloo repository.
git clone https://github.com/Lookyloo/lookyloo.git
Run the commands:
poetry install echo LOOKYLOO_HOME="'`pwd`'" > .env
Install the dependencies for playwright (requires sudo), and the browsers:
Initialize the user configuration
cp config/generic.json.sample config/generic.json cp config/modules.json.sample config/modules.json
Edit the config files accordingly to your needs: see the
_noteskey in the JSON file. You can also look at the integration page for more information regarding the modules, and the configuration page for the generic configuration options.
Make sure the configuration files are valid, and pull the 3rd party dependencies for the website
poetry run update --yes
Unless you changed the default in
config/generic.json, the web interface will be reachable at
In order to use the Universal Whois you have to install uwhoisd from Lookyloo repository and the whois package:
sudo apt-get update
sudo apt-get install whois
git clone https://github.com/Lookyloo/uwhoisd
echo UWHOISD_HOME="'`pwd`'" > .env
poetry run start
Then configure the service file
sudo cp etc/systemd/system/uwhoisd.service.sample /etc/systemd/system/uwhoisd.service
sudo systemctl daemon-reload
sudo systemctl start uwhoisd
sudo systemctl status uwhoisd
If everything is ok, activate the service for reboot
sudo systemctl enable uwhoisd