||2 weeks ago|
|.github||2 weeks ago|
|.vscode||9 months ago|
|backups||8 months ago|
|computers||8 months ago|
|core||8 months ago|
|customers||8 months ago|
|devices||8 months ago|
|docs||8 months ago|
|licenses||8 months ago|
|nets||8 months ago|
|network_inventory||8 months ago|
|nginx||3 years ago|
|softwares||8 months ago|
|users||2 weeks ago|
|.coveragerc||3 years ago|
|.dir-locals.el||3 years ago|
|.env-example||8 months ago|
|.envrc||9 months ago|
|.flake8||3 years ago|
|.gitignore||9 months ago|
|.gitlab-ci.yml||2 years ago|
|Dockerfile||10 months ago|
|LICENSE||5 years ago|
|Makefile||2 weeks ago|
|README.md||10 months ago|
|conftest.py||8 months ago|
|docker-compose-development.yml||10 months ago|
|docker-compose.yml||10 months ago|
|flake.lock||2 weeks ago|
|flake.nix||2 weeks ago|
|manage.py||8 months ago|
|network_inventory.yaml||8 months ago|
|poetry.lock||2 weeks ago|
|poetry.toml||3 weeks ago|
|pyproject.toml||2 weeks ago|
|pytest.ini||8 months ago|
|run.sh||11 months ago|
I started this project in order to have solution for keeping an inventory over my various servers and other network equipment.
- Clone the repository
- Copy the
.envand change the
DJANGO_SECRET_KEYvariables to something secure.
docker-compose upand connect to http://localhost
Local Development Setup
The local setup is mainly intended to run the tests quickly. I recommend that you use the Docker setup if you want to interact with the website.
make localto create the virtual environment for development. You're now all set to start developing.
Docker Development Setup
This is very similar to the production setup with the difference that the image
web application gets built locally instead of getting pulled from
maketo start the server. You can access it at http://localhost . You're now all set to start working.
- If you want to have some example data to work with run the command
make initafter you successfully run
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_DEBUG settings this variable to any value enables the Django debug mode. Make sure that you don't set it on a production server.
- DJANGO_SETTINGS_MODULE the path to the settings file to use in the
container. This requires a dotet syntax. The default is
Currently there isn't a lot of documentation present. I try to document my thoughts and other related information in the Notes file.