Merge pull request #334 from silversword411/mkdocsupdate8-9

silversword411 · web-flow · commit 0de968f4d437 · 2025-12-19T16:06:04.000-05:00
mkdocs Upgrade: Fixing links etc
diff --git a/docs/functions/custom_fields.md b/docs/functions/custom_fields.md
@@ -53,7 +53,7 @@ Tactical RMM supports automatically collecting information and saving them direc
 !!!info
     To populate a multiple select custom field, return a string with the options separated by a comma `"This,will,be,an,array"`.
 
-For more information See [Collector Tasks](automated_tasks.md#Collector Tasks).
+For more information See [Collector Tasks](automated_tasks.md#collector-tasks).
 
 ## Video Walkthru
 
diff --git a/docs/functions/scripting.md b/docs/functions/scripting.md
@@ -262,7 +262,7 @@ See a full list of possible built-in variables [Here](../script_variables.md)
 
 Tactical RMM supports pulling data from custom fields using the {{model.custom_field_name}} syntax.
 
-See [Using Custom Fields in Scripts](custom_fields.md#Using Custom Fields in Scripts).
+See [Using Custom Fields in Scripts](custom_fields.md#using-custom-fields-in-scripts).
 
 ### Getting values from the Global Keystore
 
diff --git a/docs/guide_gettingstarted.md b/docs/guide_gettingstarted.md
@@ -30,13 +30,13 @@ Install the server, [choose the best path](install_considerations.md)
 
 * [ ] TRMM Server [OS updates](update_server.md#video-walkthru){target=_blank}
 * [ ] Reboot TRMM server
-* [ ] Renew [LetsEncrypt Certs](update_server.md#keeping-your-lets-encrypt-certificate-up-to-date){target=_blank}
+* [ ] Renew [LetsEncrypt Certs](update_server.md#keeping-your-ssl-certificates-up-to-date){target=_blank}
 * [ ] [Update TRMM](update_server.md#updating-to-the-latest-rmm-version){target=_blank}
 * [ ] Check your backups. Especially scheduled ones and make sure you're running the latest `./backup.sh` (You're reading the [release notes](https://github.com/amidaware/tacticalrmm/releases) at every update, right?)
 
 ## Bi-annually
 
-* [ ] Clean up [old agents](management_cmds.md#bulk-delete-old-agents-by-last-checkin-date-or-agent-version){target=_blank}
+* [ ] Clean up [old agents](management_cmds.md#bulk-delete-agents-last-check-in-agent-version-site-or-client){target=_blank}
 
 ## Don't do these things
 
diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
@@ -1,9 +1,5 @@
 # Troubleshooting
 
-## I just updated and now it doesn't work.
-
-It's just a blank white screen, nothing will load when I refresh. [See](faq.md#i-just-updated-and-now-it-doesnt-work).
-
 ## Server Troubleshooting Script
 
 If you've asked for help in [#support](https://discord.com/channels/736478043522072608/744282073870630912) please run this, and send a screenshot at the top of the thread created for troubleshooting your issue.
@@ -100,7 +96,7 @@ It will most probably be a CORS error which means you need to check your DNS set
 
 If you see an error about SSL or certificate expired, then your Let's Encrypt cert has probably expired and you'll need to renew it.
 
-Refer to the Let's Encrypt cert renewal instructions [here](update_server.md#keeping-your-lets-encrypt-ssl-certificate-up-to-date).
+Refer to the Let's Encrypt cert renewal instructions [here](update_server.md#keeping-your-ssl-certificates-up-to-date).
 
 ## Agents not installing or updating
 
@@ -134,7 +130,7 @@ The mesh installer is created at time of install. Make sure it's working by runn
 
 !!!warning
     As of v0.12.0 `Error 1005` usually means something doesn't match and / or the mesh username has to be all lower case.<br>
-    If you customize the "Mesh Device Group Name" in Tactical's settings you **MUST** also manually match that Mesh Group in mesh itself [because you must understand](mesh_integration.md#security-implications).
+    If you customize the "Mesh Device Group Name" in Tactical's settings you **MUST** also manually match that Mesh Group in mesh itself.
 
 [Collect Update debug logs for troubleshooting agents that don't update](update_agents.md#manually-updating-from-the-command-line-on-the-agent)
 
diff --git a/docs/unsupported_guidelines.md b/docs/unsupported_guidelines.md
@@ -32,7 +32,7 @@ Should you employ any one or several of these unsupported technologies:
 
 Please let us know **BEFORE** we start troubleshooting and looking for software bugs that you are... in fact... a 🧙... and using something non-standard. 😉 
 
-These are "unsupported" because then we are troubleshooting **your** environment, not Tactical RMM. You need to have knowledge about how things work if you're going to stray from the [easy path](install_server.md#option-1-easy-install) of the standard install. 
+These are "unsupported" because then we are troubleshooting **your** environment, not Tactical RMM. You need to have knowledge about how things work if you're going to stray from the [easy path](install_server.md#option-1-easy-install-on-a-vps) of the standard install. 
 
 Help us maximize keeping developer time and resources focused on new releases... not supporting goosechases.
 
diff --git a/docs/unsupported_proxies.md b/docs/unsupported_proxies.md
@@ -1207,8 +1207,6 @@ You should now see something like this in your list of SSL Certs:
 
 Go ahead and download this certificate by clicking the 3 dots to the right of the cert entry and click "Download".
 
-I suggest you follow [these](unsupported_scripts.md/#using-purchased-ssl-certs-instead-of-lets-encrypt-wildcards) instructions for adding the new certs to your TRMM instance. You will still need to keep TRMM's certs updated as well.
-
 #### MeshCentral Configuration
 
 Now you should have Nginx Proxy Manager completely setup. Lets move on to the MeshCentral Configuration.
diff --git a/docs/update_agents.md b/docs/update_agents.md
@@ -31,7 +31,7 @@ For example, agents older than version 1.3.0 must first be updated to 1.3.0 befo
 
 You should never need to do this but might be needed to troubleshoot agents that are not updating automatically.
 
-Download the `tacticalagent-vX.X.X.exe` installer from the link generated by the [Manual](./install_agent.md#manual]) install method and place it somewhere on the filesystem.
+Download the `tacticalagent-vX.X.X.exe` installer from the link generated by the [Manual](./install_agent.md#manual) install method and place it somewhere on the filesystem.
 
 Open CMD as admin and call the exe like so:
 
diff --git a/docs/update_server.md b/docs/update_server.md
@@ -1,13 +1,5 @@
 # Updating the RMM
 
-[Keeping your Linux server up to date](#keeping-your-linux-server-up-to-date)
-
-[Updating to the latest RMM version](#updating-to-the-latest-rmm-version)
-
-[Keeping your Let's Encrypt certificate up to date](#keeping-your-lets-encrypt-ssl-certificate-up-to-date)
-
-[Video Walkthru](#video-walkthru)
-
 ## Keeping your Linux server up to date
 
 You should periodically run `sudo apt update` and `sudo apt -y upgrade` to keep your server up to date.
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -149,8 +149,8 @@ markdown_extensions:
   - toc:
       permalink: true
   - pymdownx.emoji:
-      emoji_index: !!python/name:materialx.emoji.twemoji
-      emoji_generator: !!python/name:materialx.emoji.to_svg
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg
   - pymdownx.superfences
   - pymdownx.tabbed:
       alternate_style: true
diff --git a/requirements.txt b/requirements.txt
@@ -1,30 +1,30 @@
-certifi==2024.2.2
-charset-normalizer==3.3.2
-click==8.1.7
+certifi==2025.11.12
+charset-normalizer==3.4.4
+click==8.3.1
 colorama==0.4.6
 ghp-import==2.1.0
-idna==3.6
-importlib-metadata==7.1.0
-Jinja2==3.1.3
-Markdown==3.6
-MarkupSafe==2.1.5
+idna==3.11
+importlib-metadata==8.7.0
+Jinja2==3.1.6
+Markdown==3.10
+MarkupSafe==3.0.3
 mergedeep==1.3.4
-mkdocs==1.5.3
-mkdocs-material==8.5.11
-mkdocs-material-extensions==1.1.1
-neoteroi-mkdocs==1.0.5
-packaging==24.0
+mkdocs==1.6.1
+mkdocs-material==9.7.0
+mkdocs-material-extensions==1.3.1
+neoteroi-mkdocs==1.2.0
+packaging==25.0
 pathspec==0.12.1
-platformdirs==4.2.0
-Pygments==2.17.2
-pymdown-extensions==10.7.1
-pyparsing==3.1.2
+platformdirs==4.5.1
+Pygments==2.19.2
+pymdown-extensions==10.19.1
+pyparsing==3.2.5
 python-dateutil==2.9.0.post0
-PyYAML==6.0.1
-pyyaml_env_tag==0.1
-regex==2023.12.25
-requests==2.31.0
-six==1.16.0
-urllib3==2.2.1
-watchdog==4.0.0
-zipp==3.18.1
+PyYAML==6.0.3
+pyyaml_env_tag==1.1
+regex==2025.11.3
+requests==2.32.5
+six==1.17.0
+urllib3==2.6.2
+watchdog==6.0.0
+zipp==3.23.0
diff --git a/startdevmkdocsonwindows.ps1 b/startdevmkdocsonwindows.ps1
@@ -1,6 +1,7 @@
 # This is for running mkdocs locally on Windows.
 # Make sure you change directory to your docs folder before starting this process
 # Use the "Run Selection" in VS Code to run the code blocks as-needed
+# On major version changes of Python, you may need to re-create the virtual environment. Just delete the .\env folder and re-run.
 
 # In case you have ExecutionPolicy problems
 Set-ExecutionPolicy -Scope CurrentUser Unrestricted
@@ -16,7 +17,7 @@ pip install -r requirements.txt
 
 # Run mkdocs and look at changes as you make them
 Start-Process http://localhost:8005 #Opens Browser
-mkdocs serve
+mkdocs serve --livereload
 
 # Deactivate Python environment
 deactivate
