I started this project in order to have solution for keeping an inventory over my various servers and other network equipment.
The idea later expanded to be an inventory for multiple customers. In addition the customers should be able to access their inventory but only see the items they own.
This project consists of the backend in Django and the frontend written in VueJS.
- Clone the repository
- Copy the
.env-examplefile to.envand change thePOSTGRES_PASSWORDandDJANGO_SECRET_KEYvariables to something secure. - Replace the value for
NI_HOSTto the domain of your website. If you want to debug the backendNI_MODEtodevelopment. - Run
docker-compose upand connect to domain defined inNI_HOST
To customise the application in the Docker container you can use environment variables in the docker-compose.yml file. Currently the following variables are supported.
- DJANGO_SECRET_KEY the secret key is mandatory, otherwise the application doesn't run. Make sure that it is some long random string.
- DJANGO_SETTINGS_MODULE the path to the settings file to use in the
container. This requires a dotet syntax. The default is
network_inventory.settings.docker. - NI_HOST the domain from you serve the application. This is required in order for the backend to work properly.
- NI_MODE the state of the application, should be
productionfor a production environment.
Currently there isn't a lot of documentation present.