Cayo Puigdefabregas e6424af251 | ||
---|---|---|
action | ||
admin | ||
api | ||
dashboard | ||
db | ||
device | ||
dhub | ||
did | ||
docker | ||
docs/es | ||
documents | ||
dpp | ||
evidence | ||
example | ||
login | ||
lot | ||
tag | ||
user | ||
utils | ||
.env.example | ||
.gitignore | ||
LICENSE | ||
README.md | ||
docker-compose.yml | ||
docker-reset.sh | ||
manage.py | ||
requirements.txt | ||
reset.sh |
README.md
Device Hub
DeviceHub is an IT Asset Management System focused on reusing devices, created under the eReuse.org project.
Overview
DeviceHub aims to:
- Provide a common IT Asset Management platform for donors, receivers, and IT professionals.
- Automatically collect, analyze, and share device metadata while ensuring privacy and traceability.
- Integrate with existing IT Asset Management Systems.
- Operate in a decentralized manner.
DeviceHub primarily works with three types of objects:
- Devices: Including computers, smartphones, and their components.
- Events: Actions performed on devices (e.g., Repair, Allocate).
- Accounts: Users who perform events on devices.
Installation
Assuming a host with debian stable
Quickstart
For a quick start with dummy data in localhost, DeviceHub can be run directly with docker. To do so, from the root of the project run:
./docker-reset.sh
Note that everytime you perform the docker-reset.sh
script, all data is lost.
Also there is a demo running in http://demo.ereuse.org/. The token for accessing the instance will be always: token=5018dd65-9abd-4a62-8896-80f34ac66150
, but the instance will be reset every day at 4 am.
For production needs, review and change .env file properly
Running from baremetal
Prerequisites
- Python 3.10
- pip
- virtualenv
Specially when developing, is quite convenient to run DeviceHub from a virtual environment. To start with this deployment, create a virtual environment to isolate our project dependencies:
python -m venv env
source env/bin/activate
pip install -r requirements.txt
System Dependencies
Xapian
Now, install the xapian dependencies (xapian library and python bindings)
sudo apt-get install python3-xapian libxapian-dev
Allow the virtual environment to use system-installed packages:
export PYTHONPATH="${PYTHONPATH}:/usr/lib/python3/dist-packages"
Environment Variables
Now, configure the environment variables. For this, we will expand a .env
file. You can use the following content as an example:
STATIC_ROOT=/tmp/static/
MEDIA_ROOT=/tmp/media/
ALLOWED_HOSTS=localhost,localhost:8000,127.0.0.1,
DOMAIN=localhost
DEBUG=True
Now, expand the environment variables:
source .env
Migrations
Now, apply migrations
python manage.py makemigrations
python manage.py migrate
Also, we can add some dummy data into the database to play along:
python manage.py add_institution Pangea
python manage.py add_user Pangea user@example.org 1234
python manage.py up_snapshots example/snapshots/ user@example.org
Run DeviceHub
Finally, we can run the DeviceHub service by running:
python manage.py runserver
Clean up
To clean up the deployment and start fresh, just delete Django's database:
rm db/*
License
DeviceHub is released under the GNU Affero General Public License v3.0.