From 49e40842c70c8728817e87a9a70c5c1be51737a1 Mon Sep 17 00:00:00 2001
From: Neil Lathwood <gh+n@laf.io>
Date: Thu, 18 May 2023 14:38:45 +0100
Subject: [PATCH] Re-add the Ubuntu Image page and links (#15041)

---
 doc/Installation/Images.md | 82 ++++++++++++++++++++++++++++++++++++++
 mkdocs.yml                 |  4 +-
 2 files changed, 84 insertions(+), 2 deletions(-)
 create mode 100644 doc/Installation/Images.md

diff --git a/doc/Installation/Images.md b/doc/Installation/Images.md
new file mode 100644
index 0000000000..4282465c31
--- /dev/null
+++ b/doc/Installation/Images.md
@@ -0,0 +1,82 @@
+# LibreNMS VMs
+
+> NOTE: We highly advise that you change all passwords on this image
+> when you deploy it!!
+>
+> NOTE: These images ship with a vagrant user, please remove this user
+> account when you deploy it!!
+>
+> NOTE: Read the above note again!
+
+We have available for download a pre-built image based on Ubuntu 22.04.
+These images are built using [packer.io](https://packer.io).
+
+Details of the image and it's setup are:
+
+At present we provide the following builds:
+
+- OVA Built with VirtualBox.
+- OVA Built for VMWare ESXi.
+- Vagrant Box file.
+
+- Any issues and or help with these images should be reported via
+  [Community Forum](https://community.librenms.org) or our [Discord
+  server](https://t.libren.ms/discord)
+
+## Setup
+
+- US Keyboard
+- Etc/UTC Timezone
+- 4 Poller Wrapper threads
+
+## Software
+
+- PHP 8.1
+- MariaDB
+- Syslog-ng
+
+## Features
+
+- Oxidized installed but not configured
+- Weathermap plugin enabled
+- Billing enabled
+- RRDCached enabled
+- Service checks enabled
+- Syslog enabled
+
+## Download
+
+All images can be downloaded from
+[GitHub](https://github.com/librenms/packer-builds/releases/latest). The
+tags follow the main LibreNMS repo. When a new LibreNMS release is
+available we will push new images out running that version. Please do
+note that if you download an older release with a view to running that
+specific version, you will need to disable updates `lnms config:set update false`.
+
+## Access/Credentials
+
+If you are using the VirtualBox image then to access your newly imported VM, 
+these ports are forwarded from your machine to the VM: 8080 for WebUI and 2023 for SSH.
+Remember to edit/remove them if you change (and you should) the VM network configuration.
+
+- WebUI (http://localhost:8080)
+  - username: librenms
+  - password: `D32fwefwef`
+
+- SSH (change the password ssh://localhost:2023)
+  - username: librenms
+  - password: `CDne3fwdfds`
+
+- SSH (remove this account)
+  - username: vagrant
+  - password; vagrant
+
+- MySQL/MariaDB
+  - username: librenms
+  - password: `D42nf23rewD`
+
+## Contributing
+
+If you would like to help with these images whether it's add
+additional features or default software / settings then you can do so
+on [GitHub](https://github.com/librenms/packer-builds/).
\ No newline at end of file
diff --git a/mkdocs.yml b/mkdocs.yml
index 977e86ee4f..b838aedf09 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -69,10 +69,9 @@ plugins:
         'Extensions/Prometheus.md': 'Extensions/metrics/Prometheus.md'
         'General/Contributing.md': 'Developing/Getting-Started.md'
         'Installation/CentOS-image.md': 'Installation/Install-LibreNMS.md'
-        'Installation/Images.md': 'Installation/Install-LibreNMS.md'
         'Installation/index.md': 'Installation/Install-LibreNMS.md'
         'Installation/Installing-LibreNMS.md': 'Installation/Install-LibreNMS.md'
-        'Installation/Ubuntu-image.md': 'Installation/Install-LibreNMS.md'
+        'Installation/Ubuntu-image.md': 'Installation/Images.md'
         'Support/Support-New-OS.md': 'Developing/Support-New-OS.md'
   - minify:
       minify_html: true
@@ -116,6 +115,7 @@ nav:
     - Installing LibreNMS: Installation/Install-LibreNMS.md
     - Other Methods:
       - Docker: Installation/Docker.md
+      - Virtual machines: Installation/Images.md
       - Older guides:
         - RHEL / CentOS 6: Installation/Installation-CentOS-6-Apache-Nginx.md
         - RHEL / CentOS 7 - Apache: Installation/Installation-CentOS-7-Apache.md