aboutsummaryrefslogtreecommitdiff
path: root/docs/onboarding/installing.rst
blob: b5c6f61c0174166e6d9298303e6f1088bbfa17c4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
Installing fingerd
==================

In order to run and tweak fingerd, you must first install it; this section
will cover the need.

Installing fingerd using pip
----------------------------

To install fingerd, you can use pip with the following command:

.. code-block:: sh

	python -m pip install fingerd

Some notes on this command:

* On most Linux distributions, you can directly call ``pip`` (or ``pip3``
  on those where Python 2.x is still the default); I personnally prefer
  to call it through Python as a module.
* On Linux and other UNIX-like distributions where Python 2.x is still the
  default, when Python 3.x is installed, you must usually call it using
  ``python3`` instead of ``python``.
* On Microsoft Windows, the Python executable, when added to the PATH,
  goes by the name ``py`` instead of ``python``.

Installing fingerd from source
------------------------------

To install fingerd from source, you can use the following commands:

.. code-block:: sh

    python -m pip install -r requirements.txt
    python ./setup.py install --system # or --user

.. _toml: https://pypi.org/project/toml/
.. _click: https://pypi.org/project/click/