Installation¶

System Requirements¶

note: Item Hut has not been built or tested on Mac OS or Windows.

(install with your package manager)

running pip3 install will download the following packages (see setup.py):

create the itemhut database:

$ su - postgres
$ createdb itemhut

If this is your first time using PostgreSQL, you have to create a password for the postgres user:

$ psql
postgres=# alter user postgres with encrypted password "<password>"
postgres=# \q

edit the pg_hba.conf (still as postgres):

$ cd data
$ [editor] pg_hba.conf

change peer to md5 then restart the PostgreSQL server. Create a .pgpass File:

cd to the home directory of the user who is running the system:

$ cd

create .pgpass:

$ touch .pgpass

edit .pgpass with your prefered editor:

$ [editor] .pgpass

add the following, filling in the bracketed:

<host>:<port>:itemhut:postgres:<password>

in general, the .pgpass file will look like this, where password is whatever you made the password when you updated the postgres user password:

localhost:5432:itemhut:postgres:<password>

clone the repo:

$ git clone https://github.com/dt1/itemhut.git

cd to directory:

$ cd itemhut

run setup:

$ pip3 install . --upgrade

setup the database:

$ python3 build_db.py

Run Itemhut:

$ python3 inventory.py

open localhost:8082 in your browser.

You will see a “Create First User” page.