{"id":49832851,"url":"https://github.com/diegogodoy06/netbox-maintenance-device","last_synced_at":"2026-05-13T21:44:40.926Z","repository":{"id":313973300,"uuid":"1053657210","full_name":"diegogodoy06/netbox-maintenance-device","owner":"diegogodoy06","description":"Netbox Plugin for maintenance devices","archived":false,"fork":false,"pushed_at":"2026-01-14T13:08:22.000Z","size":581,"stargazers_count":20,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-14T15:43:47.898Z","etag":null,"topics":["netbox","netbox-plugin"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/diegogodoy06.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-09T18:44:02.000Z","updated_at":"2026-01-14T13:08:25.000Z","dependencies_parsed_at":"2025-09-09T22:31:02.259Z","dependency_job_id":"63b83e1f-254d-4b76-88f9-f93a6faeb21a","html_url":"https://github.com/diegogodoy06/netbox-maintenance-device","commit_stats":null,"previous_names":["diegogodoy06/netbox-maintenance-device"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/diegogodoy06/netbox-maintenance-device","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diegogodoy06%2Fnetbox-maintenance-device","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diegogodoy06%2Fnetbox-maintenance-device/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diegogodoy06%2Fnetbox-maintenance-device/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diegogodoy06%2Fnetbox-maintenance-device/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/diegogodoy06","download_url":"https://codeload.github.com/diegogodoy06/netbox-maintenance-device/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diegogodoy06%2Fnetbox-maintenance-device/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33001378,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-13T13:14:54.681Z","status":"ssl_error","status_checked_at":"2026-05-13T13:14:51.610Z","response_time":115,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["netbox","netbox-plugin"],"created_at":"2026-05-13T21:44:40.304Z","updated_at":"2026-05-13T21:44:40.918Z","avatar_url":"https://github.com/diegogodoy06.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NetBox Maintenance Device Plugin\n\n[![NetBox](https://img.shields.io/badge/NetBox-4.0%2B-orange)](https://netbox.dev/)\n[![PyPI](https://img.shields.io/pypi/v/netbox-maintenance-device)](https://pypi.org/project/netbox-maintenance-device/)\n[![PyPI Downloads](https://static.pepy.tech/personalized-badge/netbox-maintenance-device?period=total\u0026units=ABBREVIATION\u0026left_color=GREY\u0026right_color=BLUE\u0026left_text=downloads)](https://pepy.tech/projects/netbox-maintenance-device)\n[![Language](https://img.shields.io/badge/Language-EN%20%7C%20PT--BR-brightgreen)](README.md)\n\nA comprehensive NetBox plugin for managing device preventive and corrective maintenance with enhanced visual indicators, scheduling capabilities, and multi-language support.\n\n![Upcoming \u0026 Overdue Maintenance](https://github.com/diegogodoy06/netbox-maintenance-device/blob/main/docs/img/Upcoming.png?raw=true)\n\n## Features\n\n- **Maintenance Plans**: Create and manage maintenance plans for devices with configurable frequency\n- **Maintenance Executions**: Record and track maintenance executions with status monitoring\n- **Device Integration**: View maintenance history directly on device pages with dedicated tabs\n- **Quick Actions**: Schedule and complete maintenance directly from the interface\n- **REST API**: Complete REST API for external integrations and automation\n- **Advanced Filtering**: Powerful filtering and search capabilities\n- **Custom Actions**: Schedule, complete, and cancel maintenance via API\n- **Statistics**: Get maintenance statistics and overdue/upcoming reports\n\n\n## Compatibility\n\n| NetBox Version | Plugin Support | Notes |\n|----------------|----------------|-------|\n| 4.5.x | **Tested \u0026 Supported** | Current target version |\n| 4.4.x | **Tested \u0026 Supported** | Fully compatible |\n| 4.3.x | **Likely Compatible** | Not officially tested |\n| 4.2.x | **Likely Compatible** | Not officially tested |\n| 4.1.x | **Likely Compatible** | Not officially tested |\n| 4.0.x | **Likely Compatible** | Not officially tested |\n| 3.x | **Not Supported** | Breaking changes |\n\n\u003e **Note**: This version (v1.2.3) is specifically tested and certified for NetBox 4.5.x and 4.4.x. While it may work with other 4.x versions, we recommend testing in a development environment first.\n\n\u003e **Python Requirements**: NetBox 4.5.x requires Python 3.12, 3.13, or 3.14. If you're using NetBox 4.4.x or earlier, you can use Python 3.8+.\n\n\n\n## Installation\n\n### Method 1: PyPI Installation (Recommended)\n\n**Now officially available on PyPI!**\n\n```bash\n# Install the latest version\npip install netbox-maintenance-device\n\n# Or install a specific version\npip install netbox-maintenance-device==1.2.3\n```\n\n**For Docker deployments**, add to your `plugin_requirements.txt`:\n```bash\necho \"netbox-maintenance-device\u003e=1.2.3\" \u003e\u003e plugin_requirements.txt\n```\n\n### Method 2: GitHub Installation\n\n```bash\n# Install from GitHub (development version)\npip install git+https://github.com/diegogodoy06/netbox-maintenance-device.git\n```\n\n### Method 3: Docker Installation\n\nFor Docker-based NetBox installations using [netbox-docker](https://github.com/netbox-community/netbox-docker):\n\n\u003e **📋 For detailed Docker installation instructions in English and Portuguese, see [DOCKER_INSTALL.md](DOCKER_INSTALL.md)**\n\n## Configuration\n\n### Basic Configuration\n\nAdd the plugin to your NetBox `configuration.py`:\n\n```python\n# configuration.py\n\nPLUGINS = [\n    'netbox_maintenance_device',\n    # ... other plugins\n]\n\n# Optional: Plugin-specific settings\nPLUGINS_CONFIG = {\n    'netbox_maintenance_device': {\n        # Future configuration options will be added here\n        # Currently, the plugin uses default settings\n    }\n}\n```\n\n### Language Configuration (Optional)\n\nTo enable Portuguese-BR by default:\n\n```python\n# configuration.py\n\n# Enable internationalization\nUSE_I18N = True\nUSE_L10N = True\n\n# Set default language\nLANGUAGE_CODE = 'pt-br'\nTIME_ZONE = 'America/Sao_Paulo'\n\n# Available languages\nLANGUAGES = [\n    ('en', 'English'),\n    ('pt-br', 'Português (Brasil)'),\n]\n```\n\n\n\n### Restart Services\n\nRestart your NetBox services:\n\n```bash\n# For systemd\nsudo systemctl restart netbox netbox-rq\n\n# For Docker\ndocker compose restart netbox netbox-worker\n```\n\n## Usage\n\nFor detailed usage instructions, please refer to the **[USAGE.md](USAGE.md)** guide, which includes:\n\n- Creating and managing maintenance plans\n- Scheduling and completing maintenance\n- Monitoring maintenance status\n- Using the REST API\n- Troubleshooting common issues\n\n**Quick Start**:\n1. Create maintenance plans for your devices\n2. View upcoming/overdue maintenance in the dashboard\n3. Use quick action buttons to schedule or complete maintenance\n4. Monitor device-specific maintenance on device pages\n\n## Screenshots\n\n### Device Maintenance Section\n*View maintenance plans and status directly on device pages*\n\n![Device Maintenance](https://github.com/diegogodoy06/netbox-maintenance-device/blob/main/docs/img/device.png?raw=true)\n\n### Upcoming Maintenance Dashboard\n*Monitor all upcoming and overdue maintenance across your infrastructure*\n\n![Upcoming Maintenance](https://github.com/diegogodoy06/netbox-maintenance-device/blob/main/docs/img/Upcoming.png?raw=true)\n\n### Maintenance Plan Management\n*Create and manage maintenance plans with flexible scheduling*\n\n![Maintenance Plans](https://github.com/diegogodoy06/netbox-maintenance-device/blob/main/docs/img/Plans.png?raw=true)\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## 📄 License\n\nThis project is licensed under the Apache 2.0 License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- NetBox community for the excellent platform\n- Contributors and users providing feedback\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdiegogodoy06%2Fnetbox-maintenance-device","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdiegogodoy06%2Fnetbox-maintenance-device","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdiegogodoy06%2Fnetbox-maintenance-device/lists"}