# Nautobot Device Onboarding
<p align="center">
<img src="https://raw.githubusercontent.com/nautobot/nautobot-app-device-onboarding/develop/docs/images/icon-DeviceOnboarding.png" class="logo" height="200px">
<br>
<a href="https://github.com/nautobot/nautobot-app-device-onboarding/actions"><img src="https://github.com/nautobot/nautobot-app-device-onboarding/actions/workflows/ci.yml/badge.svg?branch=main"></a>
<a href="https://docs.nautobot.com/projects/device-onboarding/en/latest/"><img src="https://readthedocs.org/projects/nautobot-plugin-device-onboarding/badge/"></a>
<a href="https://pypi.org/project/nautobot-device-onboarding/"><img src="https://img.shields.io/pypi/v/nautobot-device-onboarding"></a>
<a href="https://pypi.org/project/nautobot-device-onboarding/"><img src="https://img.shields.io/pypi/dm/nautobot-device-onboarding"></a>
<br>
An <a href="https://networktocode.com/nautobot-apps/">App</a> for <a href="https://nautobot.com/">Nautobot</a>.
</p>
## Overview
The `nautobot-device-onboarding` plugin is using the [netmiko](https://github.com/ktbyers/netmiko) and [NAPALM](https://napalm.readthedocs.io/en/latest/) libraries to simplify the onboarding process of a new device into Nautobot down to, in many cases, an *IP Address* and a *Location*. In some cases, the user may also have to specify a specific *Device Platform* and *Device Port*.
Regardless, the Onboarding App greatly simplifies the onboarding process by allowing the user to specify a small amount of info and having the app populate a much larger amount of device data in Nautobot.
### Support Matrix (Sync Devices From Network)
| Data Attribute | Cisco IOS | Cisco XE | Cisco NXOS | Cisco WLC | Juniper Junos | Arista EOS | F5 | HP Comware |
| ----------------------- | :----------------: | :--------------: | :--------------: | :--------------: | :--------------: | :--------------: | :-: | :-: |
| Hostname | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | 🧪 |
| Platform | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | 🧪 |
| Manufacturer | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | 🧪 |
| Serial Number | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | 🧪 |
| Device Type | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | 🧪 |
| Mgmt Interface | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | 🧪 |
| Mgmt IP Address | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | 🧪 |
### Support Matrix (Sync Data From Network)
| Interfaces | Cisco IOS | Cisco XE | Cisco NXOS | Cisco WLC | Juniper Junos | Arista EOS | F5 |
| ----------------------- | :----------------: | :--------------: | :--------------: | :--------------: | :--------------: | :--------------: | :-: |
| Name | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ |
| IP Address | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ |
| Type | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ |
| MTU | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ |
| Description | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ |
| Mac Address | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ |
| Link Status | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ |
| 802.1Q mode | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ |
| Lag Member | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ |
| Vrf Membership | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ |
| VLANS | Cisco IOS | Cisco XE | Cisco NXOS | Cisco WLC | Juniper Junos | Arista EOS | F5 |
| ----------------------- | :----------------: | :--------------: | :--------------: | :--------------: | :--------------: | :--------------: | :-: |
| Untagged VLANs | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ |
| Tagged VLANs | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ |
| Cabling | Cisco IOS | Cisco XE | Cisco NXOS | Cisco WLC | Juniper Junos | Arista EOS | F5 |
| ----------------------- | :----------------: | :--------------: | :--------------: | :--------------: | :--------------: | :--------------: | :-: |
| Terminations A | 🧪 | 🧪 | 🧪 | ❌ | 🧪 | ❌ | ❌ |
| Terminations B | 🧪 | 🧪 | 🧪 | ❌ | 🧪 | ❌ | ❌ |
| Legend |
| :---- |
| ✅ - Supported and stable. |
| ❌ - No current support. |
| 🧪 - Supported, but has limited testing. |
### Screenshots
Device Onboarding is a Job that allows you to provide a few required pieces of information and onboard the device.
![job input](https://raw.githubusercontent.com/nautobot/nautobot-app-device-onboarding/develop/docs/images/sync_devices_inputs.png)
## Try it out!
This App is installed in the Nautobot Community Sandbox found over at [demo.nautobot.com](https://demo.nautobot.com/)!
> For a full list of all the available always-on sandbox environments, head over to the main page on [networktocode.com](https://www.networktocode.com/nautobot/sandbox-environments/).
## Documentation
Full web-based HTML documentation for this app can be found over on the [Nautobot Docs](https://docs.nautobot.com/) website:
- [User Guide](https://docs.nautobot.com/projects/device-onboarding/en/latest/user/app_overview/) - Overview, Using the App, Getting Started.
- [Administrator Guide](https://docs.nautobot.com/projects/device-onboarding/en/latest/admin/install/) - How to Install, Configure, Upgrade, or Uninstall the App.
- [Developer Guide](https://docs.nautobot.com/projects/device-onboarding/en/latest/dev/contributing/) - Extending the App, Code Reference, Contribution Guide.
- [Release Notes / Changelog](https://docs.nautobot.com/projects/device-onboarding/en/latest/admin/release_notes/).
- [Frequently Asked Questions](https://docs.nautobot.com/projects/device-onboarding/en/latest/user/faq/).
### Contributing to the Docs
You can find all the Markdown source for the App documentation under the [`docs`](https://github.com/nautobot/nautobot-app-device-onboarding/tree/develop/docs) folder in this repository. For simple edits, a Markdown capable editor is sufficient: clone the repository and edit away.
If you need to view the fully generated documentation site, you can build it with [mkdocs](https://www.mkdocs.org/). A container hosting the docs will be started using the invoke commands (details in the [Development Environment Guide](https://docs.nautobot.com/projects/device-onboarding/en/latest/dev/dev_environment/#docker-development-environment)) on [http://localhost:8001](http://localhost:8001). As your changes are saved, the live docs will be automatically reloaded.
Any PRs with fixes or improvements are very welcome!
## Questions
For any questions or comments, please check the [FAQ](https://docs.nautobot.com/projects/device-onboarding/en/latest/user/faq/) first. Feel free to also swing by the [Network to Code Slack](https://networktocode.slack.com/) (channel `#nautobot`), sign up [here](http://slack.networktocode.com/) if you don't have an account.
Raw data
{
"_id": null,
"home_page": "https://github.com/nautobot/nautobot-app-device-onboarding",
"name": "nautobot-device-onboarding",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.8",
"maintainer_email": null,
"keywords": "nautobot, nautobot-app, nautobot-plugin",
"author": "Network to Code, LLC",
"author_email": "info@networktocode.com",
"download_url": "https://files.pythonhosted.org/packages/fb/83/e18a30d471751ed4f4f57a9b9fabd67d8b03bfd59b056da06916819632a0/nautobot_device_onboarding-4.1.0.tar.gz",
"platform": null,
"description": "# Nautobot Device Onboarding\n\n<p align=\"center\">\n <img src=\"https://raw.githubusercontent.com/nautobot/nautobot-app-device-onboarding/develop/docs/images/icon-DeviceOnboarding.png\" class=\"logo\" height=\"200px\">\n <br>\n <a href=\"https://github.com/nautobot/nautobot-app-device-onboarding/actions\"><img src=\"https://github.com/nautobot/nautobot-app-device-onboarding/actions/workflows/ci.yml/badge.svg?branch=main\"></a>\n <a href=\"https://docs.nautobot.com/projects/device-onboarding/en/latest/\"><img src=\"https://readthedocs.org/projects/nautobot-plugin-device-onboarding/badge/\"></a>\n <a href=\"https://pypi.org/project/nautobot-device-onboarding/\"><img src=\"https://img.shields.io/pypi/v/nautobot-device-onboarding\"></a>\n <a href=\"https://pypi.org/project/nautobot-device-onboarding/\"><img src=\"https://img.shields.io/pypi/dm/nautobot-device-onboarding\"></a>\n <br>\n An <a href=\"https://networktocode.com/nautobot-apps/\">App</a> for <a href=\"https://nautobot.com/\">Nautobot</a>.\n</p>\n\n## Overview\n\nThe `nautobot-device-onboarding` plugin is using the [netmiko](https://github.com/ktbyers/netmiko) and [NAPALM](https://napalm.readthedocs.io/en/latest/) libraries to simplify the onboarding process of a new device into Nautobot down to, in many cases, an *IP Address* and a *Location*. In some cases, the user may also have to specify a specific *Device Platform* and *Device Port*.\n\nRegardless, the Onboarding App greatly simplifies the onboarding process by allowing the user to specify a small amount of info and having the app populate a much larger amount of device data in Nautobot.\n\n### Support Matrix (Sync Devices From Network)\n\n| Data Attribute | Cisco IOS | Cisco XE | Cisco NXOS | Cisco WLC | Juniper Junos | Arista EOS | F5 | HP Comware |\n| ----------------------- | :----------------: | :--------------: | :--------------: | :--------------: | :--------------: | :--------------: | :-: | :-: |\n| Hostname | \u2705 | \u2705 | \u2705 | \u2705 | \u2705 | \u2705 | \u274c | \ud83e\uddea |\n| Platform | \u2705 | \u2705 | \u2705 | \u2705 | \u2705 | \u2705 | \u274c | \ud83e\uddea |\n| Manufacturer | \u2705 | \u2705 | \u2705 | \u2705 | \u2705 | \u2705 | \u274c | \ud83e\uddea |\n| Serial Number | \u2705 | \u2705 | \u2705 | \u2705 | \u2705 | \u2705 | \u274c | \ud83e\uddea |\n| Device Type | \u2705 | \u2705 | \u2705 | \u2705 | \u2705 | \u2705 | \u274c | \ud83e\uddea |\n| Mgmt Interface | \u2705 | \u2705 | \u2705 | \u2705 | \u2705 | \u2705 | \u274c | \ud83e\uddea |\n| Mgmt IP Address | \u2705 | \u2705 | \u2705 | \u2705 | \u2705 | \u2705 | \u274c | \ud83e\uddea |\n\n### Support Matrix (Sync Data From Network)\n\n| Interfaces | Cisco IOS | Cisco XE | Cisco NXOS | Cisco WLC | Juniper Junos | Arista EOS | F5 |\n| ----------------------- | :----------------: | :--------------: | :--------------: | :--------------: | :--------------: | :--------------: | :-: |\n| Name | \u2705 | \u2705 | \u2705 | \u274c | \u2705 | \u2705 | \u274c |\n| IP Address | \u2705 | \u2705 | \u2705 | \u274c | \u2705 | \u2705 | \u274c |\n| Type | \u2705 | \u2705 | \u2705 | \u274c | \u2705 | \u2705 | \u274c |\n| MTU | \u2705 | \u2705 | \u2705 | \u274c | \u2705 | \u2705 | \u274c |\n| Description | \u2705 | \u2705 | \u2705 | \u274c | \u2705 | \u2705 | \u274c |\n| Mac Address | \u2705 | \u2705 | \u2705 | \u274c | \u2705 | \u2705 | \u274c |\n| Link Status | \u2705 | \u2705 | \u2705 | \u274c | \u2705 | \u2705 | \u274c |\n| 802.1Q mode | \u2705 | \u2705 | \u2705 | \u274c | \u2705 | \u2705 | \u274c |\n| Lag Member | \u2705 | \u2705 | \u2705 | \u274c | \u2705 | \u2705 | \u274c |\n| Vrf Membership | \u2705 | \u2705 | \u2705 | \u274c | \u2705 | \u2705 | \u274c |\n\n| VLANS | Cisco IOS | Cisco XE | Cisco NXOS | Cisco WLC | Juniper Junos | Arista EOS | F5 |\n| ----------------------- | :----------------: | :--------------: | :--------------: | :--------------: | :--------------: | :--------------: | :-: |\n| Untagged VLANs | \u2705 | \u2705 | \u2705 | \u274c | \u2705 | \u2705 | \u274c |\n| Tagged VLANs | \u2705 | \u2705 | \u2705 | \u274c | \u2705 | \u2705 | \u274c |\n\n| Cabling | Cisco IOS | Cisco XE | Cisco NXOS | Cisco WLC | Juniper Junos | Arista EOS | F5 |\n| ----------------------- | :----------------: | :--------------: | :--------------: | :--------------: | :--------------: | :--------------: | :-: |\n| Terminations A | \ud83e\uddea | \ud83e\uddea | \ud83e\uddea | \u274c | \ud83e\uddea | \u274c | \u274c |\n| Terminations B | \ud83e\uddea | \ud83e\uddea | \ud83e\uddea | \u274c | \ud83e\uddea | \u274c | \u274c |\n\n| Legend |\n| :---- |\n| \u2705 - Supported and stable. |\n| \u274c - No current support. |\n| \ud83e\uddea - Supported, but has limited testing. |\n\n### Screenshots\n\nDevice Onboarding is a Job that allows you to provide a few required pieces of information and onboard the device.\n\n![job input](https://raw.githubusercontent.com/nautobot/nautobot-app-device-onboarding/develop/docs/images/sync_devices_inputs.png)\n\n## Try it out!\n\nThis App is installed in the Nautobot Community Sandbox found over at [demo.nautobot.com](https://demo.nautobot.com/)!\n\n> For a full list of all the available always-on sandbox environments, head over to the main page on [networktocode.com](https://www.networktocode.com/nautobot/sandbox-environments/).\n\n## Documentation\n\nFull web-based HTML documentation for this app can be found over on the [Nautobot Docs](https://docs.nautobot.com/) website:\n\n- [User Guide](https://docs.nautobot.com/projects/device-onboarding/en/latest/user/app_overview/) - Overview, Using the App, Getting Started.\n- [Administrator Guide](https://docs.nautobot.com/projects/device-onboarding/en/latest/admin/install/) - How to Install, Configure, Upgrade, or Uninstall the App.\n- [Developer Guide](https://docs.nautobot.com/projects/device-onboarding/en/latest/dev/contributing/) - Extending the App, Code Reference, Contribution Guide.\n- [Release Notes / Changelog](https://docs.nautobot.com/projects/device-onboarding/en/latest/admin/release_notes/).\n- [Frequently Asked Questions](https://docs.nautobot.com/projects/device-onboarding/en/latest/user/faq/).\n\n### Contributing to the Docs\n\nYou can find all the Markdown source for the App documentation under the [`docs`](https://github.com/nautobot/nautobot-app-device-onboarding/tree/develop/docs) folder in this repository. For simple edits, a Markdown capable editor is sufficient: clone the repository and edit away.\n\nIf you need to view the fully generated documentation site, you can build it with [mkdocs](https://www.mkdocs.org/). A container hosting the docs will be started using the invoke commands (details in the [Development Environment Guide](https://docs.nautobot.com/projects/device-onboarding/en/latest/dev/dev_environment/#docker-development-environment)) on [http://localhost:8001](http://localhost:8001). As your changes are saved, the live docs will be automatically reloaded.\n\nAny PRs with fixes or improvements are very welcome!\n\n## Questions\n\nFor any questions or comments, please check the [FAQ](https://docs.nautobot.com/projects/device-onboarding/en/latest/user/faq/) first. Feel free to also swing by the [Network to Code Slack](https://networktocode.slack.com/) (channel `#nautobot`), sign up [here](http://slack.networktocode.com/) if you don't have an account.\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "A app for Nautobot to easily onboard new devices.",
"version": "4.1.0",
"project_urls": {
"Homepage": "https://github.com/nautobot/nautobot-app-device-onboarding",
"Repository": "https://github.com/nautobot/nautobot-app-device-onboarding"
},
"split_keywords": [
"nautobot",
" nautobot-app",
" nautobot-plugin"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "bbf2448d18984b1e79af4989fd9a68cdbb799d4ef856a3ee6c2f77ef8d0aecdc",
"md5": "795f37c201c15c04649fd9cc3f9f56c5",
"sha256": "128a899d2e38b4e25895b3a54fbedb56ad1d4cb15f1f5a86d6683d2257664455"
},
"downloads": -1,
"filename": "nautobot_device_onboarding-4.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "795f37c201c15c04649fd9cc3f9f56c5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.8",
"size": 2385938,
"upload_time": "2024-10-23T13:59:55",
"upload_time_iso_8601": "2024-10-23T13:59:55.690763Z",
"url": "https://files.pythonhosted.org/packages/bb/f2/448d18984b1e79af4989fd9a68cdbb799d4ef856a3ee6c2f77ef8d0aecdc/nautobot_device_onboarding-4.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fb83e18a30d471751ed4f4f57a9b9fabd67d8b03bfd59b056da06916819632a0",
"md5": "469001af0665e9eb30a0c4812b62d218",
"sha256": "87b019e7f9b67d4e95a94d4b2a51f1a2212e6023353e21f9734ac5e6269233ac"
},
"downloads": -1,
"filename": "nautobot_device_onboarding-4.1.0.tar.gz",
"has_sig": false,
"md5_digest": "469001af0665e9eb30a0c4812b62d218",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.8",
"size": 2205896,
"upload_time": "2024-10-23T13:59:57",
"upload_time_iso_8601": "2024-10-23T13:59:57.778282Z",
"url": "https://files.pythonhosted.org/packages/fb/83/e18a30d471751ed4f4f57a9b9fabd67d8b03bfd59b056da06916819632a0/nautobot_device_onboarding-4.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-23 13:59:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "nautobot",
"github_project": "nautobot-app-device-onboarding",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "nautobot-device-onboarding"
}