updated pandoc options

.gitignore

@@ -124,3 +124,12 @@ build/*.xdy
 # WinEdt
 build/*.bak
 build/*.sav
+
+#VScode
+.vscode
+.vscode/*
+settings.json
+
+#ENV
+.aider*
+.env

.vscode/settings.json

@@ -0,0 +1,6 @@
+{
+    "workbench.colorCustomizations": {
+        "titleBar.activeBackground": "#58535bdd",
+        "activityBar.background": "#4c474faa"
+    }
+}

README.md

@@ -4,15 +4,15 @@ This cheat sheet contains commands and examples for [Qubes OS](https://www.qubes
 
 ## Downloads
 
-- **Markdown (Text): [qubes-cheatsheet.md](https://github.com/Jeeppler/qubes-cheatsheet/blob/master/qubes-cheatsheet.md)**
+- **Markdown (Text): [qubes-cheatsheet.md](https://github.com/netbones/qubes-cheatsheet/blob/master/qubes-cheatsheet.md)**
 
-- **PDF: [qubes-cheatsheet.pdf](https://github.com/Jeeppler/qubes-cheatsheet/raw/master/qubes-cheatsheet.pdf)**
+- **PDF: [qubes-cheatsheet.pdf](https://github.com/netbones/qubes-cheatsheet/blob/master/qubes-cheatsheet.pdf)**
 
-- **HTML: [qubes-cheatsheet.html](https://htmlpreview.github.io/?https://github.com/Jeeppler/qubes-cheatsheet/blob/master/qubes-cheatsheet.html)**
+- **HTML: [qubes-cheatsheet.html](https://htmlpreview.github.io/?https://github.com/netbones/qubes-cheatsheet/blob/master/qubes-cheatsheet.html)**
 
-- **Text: [qubes-cheatsheet.txt](https://github.com/Jeeppler/qubes-cheatsheet/raw/master/qubes-cheatsheet.txt)**
+- **Text: [qubes-cheatsheet.txt](https://github.com/netbones/qubes-cheatsheet/blob/master/qubes-cheatsheet.txt)**
 
-*The files are generated with the help of [`generate.sh`](https://github.com/Jeeppler/qubes-cheatsheet/blob/master/generate.sh)*
+*The files are generated with the help of [`generate.sh`](https://github.com/ubuntupunk/qubes-cheatsheet/blob/master/generate.sh)*
 
 ## Other formats
 
@@ -26,10 +26,10 @@ Pandoc can generate different files from one [markdown](http://daringfireball.ne
 pandoc metadata.yaml qubes-cheatsheet.md -s -o qubes-cheatsheet.pdf
 
 # outputs the qubes cheat sheet as HTML (HTML5) file
-pandoc metadata.yaml qubes-cheatsheet.md -s -S -t html5 -o qubes-cheatsheet.html
+pandoc metadata.yaml qubes-cheatsheet.md -s -t html5 -o qubes-cheatsheet.html
 
 # outputs the qubes cheat sheet as plain text
-pandoc qubes-cheatsheet.md -s -S -t plain -o qubes-cheatsheet.txt
+pandoc qubes-cheatsheet.md -s -t plain -o qubes-cheatsheet.txt
 ```
 
 `qubes-cheatsheet.md` is the input file and `qubes-cheatsheet.xxx` the output file.

additional/additional.md

@@ -0,0 +1,79 @@
+
+## Troubleshooting
+
+SEE: **Qubes VM troubleshooting](https://www.qubes-os.org/doc/vm-troubleshooting/)**
+
+https://forum.qubes-os.org/t/qubes-salt-beginners-guide/20126
+
+### [WARNING] top_file merging strategy is set to 'merge' and multiple top files were found. Merging order in not deterministic, it may be desirable to either set top_file_merging_strategy  to 'same' or use the 'env_order' configuration parameter to specify the merging order.
+
+set these keys in /etc/salt/minion.d/f_defaults.conf:
+
+```
+top_file_merging_strategy: merge
+env_order: ['base', 'user']
+```
+
+### [CRITICAL] Specified ext_pillar interface qvm_prefs is unavailable.
+
+Excute the following commands:
+
+ ```
+qubesctl saltutil.clear_cache
+qubesctl saltutil.sync_all refresh=true
+
+qubesctl saltutil.sync_all 
+
+sudo qubes state.highstate
+ ```
+
+
+
+ ### TLDR
+
+```
+qubesctl saltutil.clear_cache
+qubesctl top.enable qvm.sys-net qvm.sys-firewall qvm.work qvm.personal qvm.untrusted qvm.vault
+```
+### for Whonix:
+```qubesctl top.enable qvm.sys-whonix qvm.anon-whonix
+```
+### for USB VM (sys-usb):
+```
+qubesctl top.enable qvm.sys-usb
+```
+### apply all the above
+```
+qubesctl state.highstate
+```
+
+### for GUI-vm
+```
+qubesctl top.enable qvm.sys-gui
+qubesctl top.enable qvm.sys-gui pillar=True
+qubesctl --all state.highstate
+```
+
+### Whonix not starting
+There were some recent Kernel updates in Qubes. In the Settings | Advanced for the TemplateVM if I switch from the (new) default 5.13.6-1.fc25 kernel back to an earlier version 5.12.14-1.fc25 then things start working normally again.
+
+If I leave the AppVM based on this template at 5.12.14-1.fc25, then it works as well.
+
+It seems that this particular Debian 10 template is the only one that breaks with the newer kernel. This template has some Snaps and other software installed. Other Debian (full & minimal) and Fedora templates appear to be working.
+
+similer kernal issue, libexenlight fails https://forum.qubes-os.org/t/libxenlight-failed-to-create-new-domain/27032/12
+## Templates, are handled through RPC policies 
+
+1. For example, you could create the file /etc/qubes/policy.d/30-user.policy in dom0 with content similar to the following:
+
+### HTTP proxy for downloading updates
+### Update Whonix templates through sys-whonix
+qubes.UpdatesProxy      *       @tag:whonix-updatevm    @default                allow target=sys-whonix
+### Deny Whonix templates from using any other qube to update
+qubes.UpdatesProxy      *       @tag:whonix-updatevm    @anyvm                  deny
+### Update all other templates through sys-firewall and deny everything else
+qubes.UpdatesProxy      *       @type:TemplateVM        @default                allow target=sys-firewall
+qubes.UpdatesProxy      *       @anyvm                  @anyvm
+
+#DNS
+https://forum.qubes-os.org/docs?topic=13749