Install Lookyloo
Requires Python 3.8 or higher (3.10 prefered), expects Ubuntu 22.04 or more recent. |
Install Lookyloo Dependencies
Install Poetry
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.
Install Redis
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
cd redis
git checkout 7.2
make
# Optionally, you can run the tests:
make test
cd ..
Install Lookyloo
Prerequisites
-
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
Procedure
-
Clone the Lookyloo repository.
git clone https://github.com/Lookyloo/lookyloo.git
-
Change directory
cd lookyloo
-
Run the commands:
poetry install echo LOOKYLOO_HOME="'`pwd`'" > .env
-
Install the dependencies for playwright (requires sudo), and the browsers:
poetry shell
playwright install-deps
playwright install
Configuration
-
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
_notes
key 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
Open the website
Unless you changed the default in config/generic.json
, the web interface will be reachable at http://0.0.0.0:5100/
Install uwhoisd (Optional)
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
cd uwhoisd
poetry install
echo UWHOISD_HOME="'`pwd`'" > .env
poetry run start
Configure services (Optional)
Then configure the service file
```bash
nano etc/systemd/system/uwhoisd.service.sample
sudo cp etc/systemd/system/uwhoisd.service.sample /etc/systemd/system/uwhoisd.service
cd ..
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