Merge branch 'netbootxyz----addition' of https://github.com/bcurran3/ansible-nas into bcurran3-netbootxyz----addition

README.md

@@ -29,6 +29,7 @@ Ansible config and a bunch of Docker containers.
 * Content management with Joomla
 * A dual panel local file manager
 * Self-service media request web application
+* A PXE server to boot OS images over the network
 
 ### Available Applications
 
@@ -47,7 +48,7 @@ Ansible config and a bunch of Docker containers.
 * [Gitea](https://gitea.io/en-us/) - Simple self-hosted GitHub clone
 * [GitLab](https://about.gitlab.com/features/) - Self-hosted GitHub clone of the highest order
 * [Glances](https://nicolargo.github.io/glances/) - for seeing the state of your system via a web browser
-* [Gotify](https://gotify.net/) Self-hosted server for sending push notifications  
+* [Gotify](https://gotify.net/) Self-hosted server for sending push notifications
 * [Grafana](https://github.com/grafana/grafana) - Dashboarding tool
 * [Guacamole](https://guacamole.apache.org/) - Web based remote desktop gateway, supports VNC, RDP and SSH
 * [Heimdall](https://heimdall.site/) - Home server dashboard
@@ -64,6 +65,7 @@ Ansible config and a bunch of Docker containers.
 * [Mylar](https://github.com/evilhero/mylar) - An automated Comic Book downloader (cbr/cbz) for use with SABnzbd, NZBGet and torrents
 * [MyMediaForAlexa](https://www.mymediaalexa.com/) - Lets you stream your music collection to your alexa device
 * [n8n](https://n8n.io") - Nodemation, a node based workflow and automation service like IFTTT.
+* [netboot.xyz](https://netboot.xyz/) - a PXE boot server
 * [Netdata](https://my-netdata.io/) - An extremely comprehensive system monitoring solution
 * [Nextcloud](https://nextcloud.com/) - A self-hosted Dropbox alternative
 * [NZBget](https://nzbget.net/) - The most efficient usenet downloader

docs/applications/netbootxyz.md

@@ -0,0 +1,15 @@
+
+# netboot.xyz
+
+Homepage: [https://netboot.xyz/](https://netboot.xyz/)
+Docker Container: [https://hub.docker.com/r/linuxserver/netbootxyz](https://hub.docker.com/r/linuxserver/netbootxyz)
+
+netboot.xyz is a way to PXE boot various operating system installers or utilities from one place within the BIOS without the need of having to go retrieve the media to run the tool. [iPXE](https://ipxe.org/) is used to provide a user friendly menu from within the BIOS that lets you easily choose the operating system you want along with any specific types of versions or bootable flags.
+
+You can remote attach the ISO to servers, set it up as a rescue option in Grub, or even set up your home network to boot to it by default so that it's always available.
+
+## Usage
+
+Set `netbootxyz_enabled: true` in your `inventories/<your_inventory>/nas.yml` file.
+
+The netbooxyz web interface can be found at http://ansible_nas_host_or_ip:3002.

docs/configuration/application_ports.md

@@ -46,6 +46,9 @@ By default, applications can be found on the ports listed below.
 | n8n             | 5678    | Bridge  | HTTP           |
 | Netdata         | 19999   | Bridge  | HTTP           |
 | Nextcloud       | 8080    | Bridge  | HTTP           |
+| netbootxyz      | 3002    | Bridge  | HTTP           |
+| netbootxyz      | 5803    | Bridge  | HTTP           |
+| netbootxyz      | 69      | Bridge  | TFTP           |
 | NZBGet          | 6789    | Bridge  | HTTP           |
 | Ombi            | 3579    | Bridge  | HTTP           |
 | openHAB         | 7777    | Host    | HTTP           |

nas.yml

@@ -163,6 +163,11 @@
         - n8n_enabled
       when: (n8n_enabled | default(False))
 
+    - role: netbootxyz
+      tags:
+        - netbootxyz
+      when: (netbootxyz_enabled | default(False))
+
     - role: netdata
       tags:
         - netdata

roles/netbootxyz/tasks/main.yml

@@ -0,0 +1,33 @@
+
+---
+- name: netbootxyz Directory
+  file:
+    path: "{{ item }}"
+    state: directory
+  with_items:
+    - "{{ netbootxyz_config_directory }}"
+    - "{{ netbootxyz_assets_directory }}"
+
+- name: netbootxyz Docker Container
+  docker_container:
+    name: netbootxyz
+    image: linuxserver/netbootxyz:latest
+    pull: true
+    volumes:
+      - "{{ netbootxyz_config_directory }}:/config:rw"
+      - "{{ netbootxyz_assets_directory }}:/assets:rw"
+    ports:
+      - "{{ netbootxyz_port_http }}:3000"
+      - "{{ netbootxyz_port_http2 }}:80"
+      - "{{ netbootxyz_port_tftp }}:69/udp"
+    env:
+      TZ: "{{ ansible_nas_timezone }}"
+      PUID: "{{ netbootxyz_user_id }}"
+      PGID: "{{ netbootxyz_group_id }}"
+    restart_policy: unless-stopped
+    labels:
+      traefik.backend: "netbootxyz"
+      traefik.frontend.rule: "Host:netbootxyz.{{ ansible_nas_domain }}"
+      traefik.enable: "{{ netbootxyz_available_externally }}"
+      traefik.port: "80"
+    memory: 1g