1# Installation instructions
2
3## pip
4
5**Note that using pip outside virtualenv is not recommended since it ignores
6your systems package manager. If you aren't comfortable debugging package
7installation issues, this is not the option for you.**
8
9Create and activate a virtualenv:
10
11```bash
12virtualenv dtfabricenv
13cd dtfabricenv
14source ./bin/activate
15```
16
17Upgrade pip and install dtFabric dependencies:
18
19```bash
20pip install --upgrade pip
21pip install dtfabric
22```
23
24To deactivate the virtualenv run:
25
26```bash
27deactivate
28```
29
30## Ubuntu 18.04 and 20.04 LTS
31
32To install dtFabric from the [GIFT Personal Package Archive (PPA)](https://launchpad.net/~gift):
33
34```bash
35sudo add-apt-repository ppa:gift/stable
36```
37
38Update and install dtFabric:
39
40```bash
41sudo apt-get update
42sudo apt-get install python3-dtfabric
43```
44
45## Windows
46
47The [l2tbinaries](https://github.com/log2timeline/l2tbinaries) contains the
48necessary packages for running dtFabric. l2tbinaries provides the following
49branches:
50
51* master; branch intended for the "packaged release" of dtFabric and dependencies;
52* dev; branch intended for the "development release" of dtFabric;
53* testing; branch intended for testing newly created packages.
54
55The l2tdevtools project provides [an update script](https://github.com/log2timeline/l2tdevtools/wiki/Update-script)
56to ease the process of keeping the dependencies up to date.
57
58The script requires [pywin32](https://github.com/mhammond/pywin32/releases) and
59[Python WMI](https://pypi.python.org/pypi/WMI/).
60
61To install the release versions of the dependencies run:
62
63```
64set PYTHONPATH=.
65
66C:\Python38\python.exe tools\update.py --preset dtfabric
67```
68