Proxbox
Proxbox is under active development and maintained on a best-effort basis during my spare time. At the moment, there is no commercial backing for the project. If you'd like to help accelerate its progress, you're very welcome to contribute by fixing issues, implementing features, and submitting a Pull Request for review.
I'd also like to express my sincere gratitude to everyone who has contributed, whether through code, bug reports, or feedback. Your help is what makes Proxbox valuable and usable across many environments.
If you'd like to further support my work, please consider sponsoring me. Thank you! 💖
Netbox Plugin which integrates Proxmox and Netbox! 🚀¶
⚠️ NOTE: Proxbox is currently under development and only performs read-only operations using
GET
requests. There is no functionality implemented to modify or change your Proxmox environment, so there's no risk of unintentional changes being made by the plugin at this stage.
Versions 📌¶
The following table shows the Netbox and Proxmox versions compatible (tested) with Proxbox plugin.
netbox version | proxmox version | proxbox version | proxbox-api | pynetbox-api |
---|---|---|---|---|
=v4.2.6 | >=8.3.0 | v0.0.6b2.post1 | v0.0.2.post3 | v0.0.2.post1 |
=v4.2.6 | >=8.3.0 | v0.0.6b2 | v0.0.2 | v0.0.2 |
=v4.2.0 | >=8.3.0 | v0.0.6b1 | v0.0.1 | v0.0.1 |
>=v3.4.0 | >=v6.2.0 | =v0.0.5 | ||
>=v3.2.0 | >=v6.2.0 | =v0.0.4 | ||
>=v3.0.0 < v3.2 | >=v6.2.0 | =v0.0.3 |
Installation 🛠️¶
TL'DR (For Experienced Users)¶
Enable plugin in configuration.py (usually on /opt/netbox/netbox/netbox)¶
PLUGINS = ['netbox_proxbox']
Run the commands to install plugin¶
# Activate virtual environment
source /opt/netbox/venv/bin/activate
# Install plugin
pip install netbox-proxbox==0.0.6b2.post1
# Run migrations
cd /opt/netbox/netbox/
python3 manage.py migrate netbox_proxbox
python3 manage.py collectstatic --no-input
# Restart service
sudo systemctl restart netbox
Setup the backend¶
The backend can be on a different venv (virtual environment) as it is a completely different service. The communication between the plugin and its backend is fully through API.
pip install proxbox-api
uvicorn main:app --host 0.0.0.0 --port 8800
For detailed installation instructions, please refer to the following guides:
- Installing using pip (recommended)
- Installing using git
- Installing using Docker