diff --git a/.gitignore b/.gitignore
index 4e42a1b..de22840 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,2 @@
-book/
\ No newline at end of file
+book/
+.DS_Store
\ No newline at end of file
diff --git a/README.md b/README.md
index b017f68..3d28c6b 100644
--- a/README.md
+++ b/README.md
@@ -1,42 +1,86 @@
# Start9 Documentation
-Welcome to the Start9 Docs! Here you will find the StartOS user manual, as well as integration guides, FAQ, support, knowledge base, and developer docs.
-## Building from source
-1. Install the necessary dependencies
+Welcome to the Start9 Docs! Here you will find the StartOS user manual, as well as integration guides, FAQ, support, knowledge base, and developer docs.
- [Rust](https://rustup.rs)
-
- ```
- curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
- ```
+## Building
- [mdBook](https://rust-lang.github.io/mdBook/) - Documentation framework
-
- `cargo install mdbook`
+1. Install dependencies
- [mdBook-admonish](https://github.com/tommilligan/mdbook-admonish) - Admonitions plugin
-
- `cargo install mdbook-admonish`
+ [Rust](https://rustup.rs)
- [mdBook-i18n](https://github.com/tommilligan/mdbook-admonish) - Internationalization plugin
-
- `cargo install mdbook-i18n`
+ `curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh`
+ [mdBook](https://rust-lang.github.io/mdBook/) - Documentation framework
-1. Clone the repo and change into its directory
-
- ```
- git clone git@github.com:kn0wmad/mdbook-docs
- cd mdbook-docs
- ```
-
-1. Serve and view a live, local version of the docs while editing
-
- `mdbook serve --open`
+ `cargo install mdbook`
- * This will automatically open your default web browser and navigate to http://localhost:3000
+ [mdBook-admonish](https://github.com/tommilligan/mdbook-admonish) - Admonitions plugin
+
+ `cargo install mdbook-admonish`
+
+ [mdBook-i18n](https://github.com/tommilligan/mdbook-admonish) - Internationalization plugin
+
+ `cargo install mdbook-i18n`
+
+2. Clone the repo and change into its directory
+
+ ```
+ git clone https://github.com/Start9Labs/docs.git
+ cd mdbook-docs
+ ```
+
+3. Serve and view a live, local version of the docs while editing
+
+ `mdbook serve --open`
+
+ This will automatically open your default web browser and navigate to http://localhost:3000
## Contributing
-We love contributions! Whether you spot a typo or want to make suggestions, you can fork this project and submit a PR with your changes for consideration. If you are not comfortable with this process, please create an issue with your suggestions or bug reports.
-If you'd like to get started contributing to Open Source software, it's easier than you think! Visit one of our [Community Channels](https://docs.start9.com/latest/support/contact) and we'll help you get started.
\ No newline at end of file
+We love contributions! Whether you spot a typo or want to make suggestions, you can fork this project and submit a PR with your changes for consideration. If you are not comfortable with this process, please create an issue with your suggestions or bug reports.
+
+If you'd like to get started contributing to open source software, it's easier than you think! Visit one of our [Community Channels](src/support/contact.md) and we'll help you get started.
+
+## Third party plugins
+
+[External link to plugins](https://github.com/rust-lang/mdBook/wiki/Third-party-plugins)
+
+## Possible `mdbook` admonitions
+
+```admonish
+A note.
+```
+
+```admonish example
+An example.
+```
+
+```admonish info
+Some info on this thing.
+```
+
+```admonish tip
+Protip on this thing.
+```
+
+```admonish warning
+You don't want to do this!
+```
+
+```admonish bug
+Bonjour sucks, but it's gone now
+```
+
+```admonish danger
+WTF ARE YOU DOING?!
+```
+
+```admonish warning title="Custom, i.e. -> POSSIBLE DATA LOSS"
+The following steps can lead to irrecoverable data corruption.
+```
+
+```admonish success title=""
+Admonition without title - This will take a while, go and grab a sandwich.
+```
+
+And tons more -> https://tommilligan.github.io/mdbook-admonish/reference.html
diff --git a/book.toml b/book.toml
index 76a06a1..822e7a3 100644
--- a/book.toml
+++ b/book.toml
@@ -1,12 +1,12 @@
[book]
-authors = ["david@start9.com"]
+authors = ["Start9"]
language = "en"
multilingual = false
src = "src"
-title = "Start9 Documentation"
+title = "Start9 Docs"
[output.html]
-additional-css = ["./mdbook-admonish.css"]
+additional-css = ["./mdbook-admonish.css", "./custom.css"]
git-repository-url = "https://github.com/start9labs/docs"
git-repository-icon = "fa-github"
edit-url-template = "https://github.com/start9labs/docs/edit/master/guide/{path}"
@@ -26,4 +26,4 @@ description = "Español"
[preprocessor.admonish]
command = "mdbook-admonish"
-assets_version = "2.0.1" # do not edit: managed by `mdbook-admonish install`
+assets_version = "3.0.2" # do not edit: managed by `mdbook-admonish install`
diff --git a/custom.css b/custom.css
new file mode 100644
index 0000000..10bbd2a
--- /dev/null
+++ b/custom.css
@@ -0,0 +1,4 @@
+.content img {
+ width: 100%;
+ max-width: 600px;
+}
\ No newline at end of file
diff --git a/mdbook-admonish.css b/mdbook-admonish.css
index 244bc9a..45aeff0 100644
--- a/mdbook-admonish.css
+++ b/mdbook-admonish.css
@@ -1,33 +1,4 @@
@charset "UTF-8";
-:root {
- --md-admonition-icon--note:
- url("data:image/svg+xml;charset=utf-8,");
- --md-admonition-icon--abstract:
- url("data:image/svg+xml;charset=utf-8,");
- --md-admonition-icon--info:
- url("data:image/svg+xml;charset=utf-8,");
- --md-admonition-icon--tip:
- url("data:image/svg+xml;charset=utf-8,");
- --md-admonition-icon--success:
- url("data:image/svg+xml;charset=utf-8,");
- --md-admonition-icon--question:
- url("data:image/svg+xml;charset=utf-8,");
- --md-admonition-icon--warning:
- url("data:image/svg+xml;charset=utf-8,");
- --md-admonition-icon--failure:
- url("data:image/svg+xml;charset=utf-8,");
- --md-admonition-icon--danger:
- url("data:image/svg+xml;charset=utf-8,");
- --md-admonition-icon--bug:
- url("data:image/svg+xml;charset=utf-8,");
- --md-admonition-icon--example:
- url("data:image/svg+xml;charset=utf-8,");
- --md-admonition-icon--quote:
- url("data:image/svg+xml;charset=utf-8,");
- --md-details-icon:
- url("data:image/svg+xml;charset=utf-8,");
-}
-
:is(.admonition) {
display: flow-root;
margin: 1.5625em 0;
@@ -75,7 +46,7 @@ a.admonition-anchor-link::before {
content: "§";
}
-:is(.admonition-title, summary) {
+:is(.admonition-title, summary.admonition-title) {
position: relative;
min-height: 4rem;
margin-block: 0;
@@ -84,21 +55,25 @@ a.admonition-anchor-link::before {
padding-inline: 4.4rem 1.2rem;
font-weight: 700;
background-color: rgba(68, 138, 255, 0.1);
+ print-color-adjust: exact;
+ -webkit-print-color-adjust: exact;
display: flex;
}
-:is(.admonition-title, summary) p {
+:is(.admonition-title, summary.admonition-title) p {
margin: 0;
}
-html :is(.admonition-title, summary):last-child {
+html :is(.admonition-title, summary.admonition-title):last-child {
margin-bottom: 0;
}
-:is(.admonition-title, summary)::before {
+:is(.admonition-title, summary.admonition-title)::before {
position: absolute;
top: 0.625em;
inset-inline-start: 1.6rem;
width: 2rem;
height: 2rem;
background-color: #448aff;
+ print-color-adjust: exact;
+ -webkit-print-color-adjust: exact;
mask-image: url('data:image/svg+xml;charset=utf-8,');
-webkit-mask-image: url('data:image/svg+xml;charset=utf-8,');
mask-repeat: no-repeat;
@@ -107,7 +82,7 @@ html :is(.admonition-title, summary):last-child {
-webkit-mask-size: contain;
content: "";
}
-:is(.admonition-title, summary):hover a.admonition-anchor-link {
+:is(.admonition-title, summary.admonition-title):hover a.admonition-anchor-link {
display: initial;
}
@@ -132,204 +107,223 @@ details[open].admonition > summary.admonition-title::after {
transform: rotate(90deg);
}
-:is(.admonition):is(.note) {
+:root {
+ --md-details-icon: url("data:image/svg+xml;charset=utf-8,");
+}
+
+:root {
+ --md-admonition-icon--admonish-note: url("data:image/svg+xml;charset=utf-8,");
+ --md-admonition-icon--admonish-abstract: url("data:image/svg+xml;charset=utf-8,");
+ --md-admonition-icon--admonish-info: url("data:image/svg+xml;charset=utf-8,");
+ --md-admonition-icon--admonish-tip: url("data:image/svg+xml;charset=utf-8,");
+ --md-admonition-icon--admonish-success: url("data:image/svg+xml;charset=utf-8,");
+ --md-admonition-icon--admonish-question: url("data:image/svg+xml;charset=utf-8,");
+ --md-admonition-icon--admonish-warning: url("data:image/svg+xml;charset=utf-8,");
+ --md-admonition-icon--admonish-failure: url("data:image/svg+xml;charset=utf-8,");
+ --md-admonition-icon--admonish-danger: url("data:image/svg+xml;charset=utf-8,");
+ --md-admonition-icon--admonish-bug: url("data:image/svg+xml;charset=utf-8,");
+ --md-admonition-icon--admonish-example: url("data:image/svg+xml;charset=utf-8,");
+ --md-admonition-icon--admonish-quote: url("data:image/svg+xml;charset=utf-8,");
+}
+
+:is(.admonition):is(.admonish-note) {
border-color: #448aff;
}
-:is(.note) > :is(.admonition-title, summary) {
+:is(.admonish-note) > :is(.admonition-title, summary.admonition-title) {
background-color: rgba(68, 138, 255, 0.1);
}
-:is(.note) > :is(.admonition-title, summary)::before {
+:is(.admonish-note) > :is(.admonition-title, summary.admonition-title)::before {
background-color: #448aff;
- mask-image: var(--md-admonition-icon--note);
- -webkit-mask-image: var(--md-admonition-icon--note);
+ mask-image: var(--md-admonition-icon--admonish-note);
+ -webkit-mask-image: var(--md-admonition-icon--admonish-note);
mask-repeat: no-repeat;
-webkit-mask-repeat: no-repeat;
mask-size: contain;
-webkit-mask-repeat: no-repeat;
}
-:is(.admonition):is(.abstract, .summary, .tldr) {
+:is(.admonition):is(.admonish-abstract, .admonish-summary, .admonish-tldr) {
border-color: #00b0ff;
}
-:is(.abstract, .summary, .tldr) > :is(.admonition-title, summary) {
+:is(.admonish-abstract, .admonish-summary, .admonish-tldr) > :is(.admonition-title, summary.admonition-title) {
background-color: rgba(0, 176, 255, 0.1);
}
-:is(.abstract, .summary, .tldr) > :is(.admonition-title, summary)::before {
+:is(.admonish-abstract, .admonish-summary, .admonish-tldr) > :is(.admonition-title, summary.admonition-title)::before {
background-color: #00b0ff;
- mask-image: var(--md-admonition-icon--abstract);
- -webkit-mask-image: var(--md-admonition-icon--abstract);
+ mask-image: var(--md-admonition-icon--admonish-abstract);
+ -webkit-mask-image: var(--md-admonition-icon--admonish-abstract);
mask-repeat: no-repeat;
-webkit-mask-repeat: no-repeat;
mask-size: contain;
-webkit-mask-repeat: no-repeat;
}
-:is(.admonition):is(.info, .todo) {
+:is(.admonition):is(.admonish-info, .admonish-todo) {
border-color: #00b8d4;
}
-:is(.info, .todo) > :is(.admonition-title, summary) {
+:is(.admonish-info, .admonish-todo) > :is(.admonition-title, summary.admonition-title) {
background-color: rgba(0, 184, 212, 0.1);
}
-:is(.info, .todo) > :is(.admonition-title, summary)::before {
+:is(.admonish-info, .admonish-todo) > :is(.admonition-title, summary.admonition-title)::before {
background-color: #00b8d4;
- mask-image: var(--md-admonition-icon--info);
- -webkit-mask-image: var(--md-admonition-icon--info);
+ mask-image: var(--md-admonition-icon--admonish-info);
+ -webkit-mask-image: var(--md-admonition-icon--admonish-info);
mask-repeat: no-repeat;
-webkit-mask-repeat: no-repeat;
mask-size: contain;
-webkit-mask-repeat: no-repeat;
}
-:is(.admonition):is(.tip, .hint, .important) {
+:is(.admonition):is(.admonish-tip, .admonish-hint, .admonish-important) {
border-color: #00bfa5;
}
-:is(.tip, .hint, .important) > :is(.admonition-title, summary) {
+:is(.admonish-tip, .admonish-hint, .admonish-important) > :is(.admonition-title, summary.admonition-title) {
background-color: rgba(0, 191, 165, 0.1);
}
-:is(.tip, .hint, .important) > :is(.admonition-title, summary)::before {
+:is(.admonish-tip, .admonish-hint, .admonish-important) > :is(.admonition-title, summary.admonition-title)::before {
background-color: #00bfa5;
- mask-image: var(--md-admonition-icon--tip);
- -webkit-mask-image: var(--md-admonition-icon--tip);
+ mask-image: var(--md-admonition-icon--admonish-tip);
+ -webkit-mask-image: var(--md-admonition-icon--admonish-tip);
mask-repeat: no-repeat;
-webkit-mask-repeat: no-repeat;
mask-size: contain;
-webkit-mask-repeat: no-repeat;
}
-:is(.admonition):is(.success, .check, .done) {
+:is(.admonition):is(.admonish-success, .admonish-check, .admonish-done) {
border-color: #00c853;
}
-:is(.success, .check, .done) > :is(.admonition-title, summary) {
+:is(.admonish-success, .admonish-check, .admonish-done) > :is(.admonition-title, summary.admonition-title) {
background-color: rgba(0, 200, 83, 0.1);
}
-:is(.success, .check, .done) > :is(.admonition-title, summary)::before {
+:is(.admonish-success, .admonish-check, .admonish-done) > :is(.admonition-title, summary.admonition-title)::before {
background-color: #00c853;
- mask-image: var(--md-admonition-icon--success);
- -webkit-mask-image: var(--md-admonition-icon--success);
+ mask-image: var(--md-admonition-icon--admonish-success);
+ -webkit-mask-image: var(--md-admonition-icon--admonish-success);
mask-repeat: no-repeat;
-webkit-mask-repeat: no-repeat;
mask-size: contain;
-webkit-mask-repeat: no-repeat;
}
-:is(.admonition):is(.question, .help, .faq) {
+:is(.admonition):is(.admonish-question, .admonish-help, .admonish-faq) {
border-color: #64dd17;
}
-:is(.question, .help, .faq) > :is(.admonition-title, summary) {
+:is(.admonish-question, .admonish-help, .admonish-faq) > :is(.admonition-title, summary.admonition-title) {
background-color: rgba(100, 221, 23, 0.1);
}
-:is(.question, .help, .faq) > :is(.admonition-title, summary)::before {
+:is(.admonish-question, .admonish-help, .admonish-faq) > :is(.admonition-title, summary.admonition-title)::before {
background-color: #64dd17;
- mask-image: var(--md-admonition-icon--question);
- -webkit-mask-image: var(--md-admonition-icon--question);
+ mask-image: var(--md-admonition-icon--admonish-question);
+ -webkit-mask-image: var(--md-admonition-icon--admonish-question);
mask-repeat: no-repeat;
-webkit-mask-repeat: no-repeat;
mask-size: contain;
-webkit-mask-repeat: no-repeat;
}
-:is(.admonition):is(.warning, .caution, .attention) {
+:is(.admonition):is(.admonish-warning, .admonish-caution, .admonish-attention) {
border-color: #ff9100;
}
-:is(.warning, .caution, .attention) > :is(.admonition-title, summary) {
+:is(.admonish-warning, .admonish-caution, .admonish-attention) > :is(.admonition-title, summary.admonition-title) {
background-color: rgba(255, 145, 0, 0.1);
}
-:is(.warning, .caution, .attention) > :is(.admonition-title, summary)::before {
+:is(.admonish-warning, .admonish-caution, .admonish-attention) > :is(.admonition-title, summary.admonition-title)::before {
background-color: #ff9100;
- mask-image: var(--md-admonition-icon--warning);
- -webkit-mask-image: var(--md-admonition-icon--warning);
+ mask-image: var(--md-admonition-icon--admonish-warning);
+ -webkit-mask-image: var(--md-admonition-icon--admonish-warning);
mask-repeat: no-repeat;
-webkit-mask-repeat: no-repeat;
mask-size: contain;
-webkit-mask-repeat: no-repeat;
}
-:is(.admonition):is(.failure, .fail, .missing) {
+:is(.admonition):is(.admonish-failure, .admonish-fail, .admonish-missing) {
border-color: #ff5252;
}
-:is(.failure, .fail, .missing) > :is(.admonition-title, summary) {
+:is(.admonish-failure, .admonish-fail, .admonish-missing) > :is(.admonition-title, summary.admonition-title) {
background-color: rgba(255, 82, 82, 0.1);
}
-:is(.failure, .fail, .missing) > :is(.admonition-title, summary)::before {
+:is(.admonish-failure, .admonish-fail, .admonish-missing) > :is(.admonition-title, summary.admonition-title)::before {
background-color: #ff5252;
- mask-image: var(--md-admonition-icon--failure);
- -webkit-mask-image: var(--md-admonition-icon--failure);
+ mask-image: var(--md-admonition-icon--admonish-failure);
+ -webkit-mask-image: var(--md-admonition-icon--admonish-failure);
mask-repeat: no-repeat;
-webkit-mask-repeat: no-repeat;
mask-size: contain;
-webkit-mask-repeat: no-repeat;
}
-:is(.admonition):is(.danger, .error) {
+:is(.admonition):is(.admonish-danger, .admonish-error) {
border-color: #ff1744;
}
-:is(.danger, .error) > :is(.admonition-title, summary) {
+:is(.admonish-danger, .admonish-error) > :is(.admonition-title, summary.admonition-title) {
background-color: rgba(255, 23, 68, 0.1);
}
-:is(.danger, .error) > :is(.admonition-title, summary)::before {
+:is(.admonish-danger, .admonish-error) > :is(.admonition-title, summary.admonition-title)::before {
background-color: #ff1744;
- mask-image: var(--md-admonition-icon--danger);
- -webkit-mask-image: var(--md-admonition-icon--danger);
+ mask-image: var(--md-admonition-icon--admonish-danger);
+ -webkit-mask-image: var(--md-admonition-icon--admonish-danger);
mask-repeat: no-repeat;
-webkit-mask-repeat: no-repeat;
mask-size: contain;
-webkit-mask-repeat: no-repeat;
}
-:is(.admonition):is(.bug) {
+:is(.admonition):is(.admonish-bug) {
border-color: #f50057;
}
-:is(.bug) > :is(.admonition-title, summary) {
+:is(.admonish-bug) > :is(.admonition-title, summary.admonition-title) {
background-color: rgba(245, 0, 87, 0.1);
}
-:is(.bug) > :is(.admonition-title, summary)::before {
+:is(.admonish-bug) > :is(.admonition-title, summary.admonition-title)::before {
background-color: #f50057;
- mask-image: var(--md-admonition-icon--bug);
- -webkit-mask-image: var(--md-admonition-icon--bug);
+ mask-image: var(--md-admonition-icon--admonish-bug);
+ -webkit-mask-image: var(--md-admonition-icon--admonish-bug);
mask-repeat: no-repeat;
-webkit-mask-repeat: no-repeat;
mask-size: contain;
-webkit-mask-repeat: no-repeat;
}
-:is(.admonition):is(.example) {
+:is(.admonition):is(.admonish-example) {
border-color: #7c4dff;
}
-:is(.example) > :is(.admonition-title, summary) {
+:is(.admonish-example) > :is(.admonition-title, summary.admonition-title) {
background-color: rgba(124, 77, 255, 0.1);
}
-:is(.example) > :is(.admonition-title, summary)::before {
+:is(.admonish-example) > :is(.admonition-title, summary.admonition-title)::before {
background-color: #7c4dff;
- mask-image: var(--md-admonition-icon--example);
- -webkit-mask-image: var(--md-admonition-icon--example);
+ mask-image: var(--md-admonition-icon--admonish-example);
+ -webkit-mask-image: var(--md-admonition-icon--admonish-example);
mask-repeat: no-repeat;
-webkit-mask-repeat: no-repeat;
mask-size: contain;
-webkit-mask-repeat: no-repeat;
}
-:is(.admonition):is(.quote, .cite) {
+:is(.admonition):is(.admonish-quote, .admonish-cite) {
border-color: #9e9e9e;
}
-:is(.quote, .cite) > :is(.admonition-title, summary) {
+:is(.admonish-quote, .admonish-cite) > :is(.admonition-title, summary.admonition-title) {
background-color: rgba(158, 158, 158, 0.1);
}
-:is(.quote, .cite) > :is(.admonition-title, summary)::before {
+:is(.admonish-quote, .admonish-cite) > :is(.admonition-title, summary.admonition-title)::before {
background-color: #9e9e9e;
- mask-image: var(--md-admonition-icon--quote);
- -webkit-mask-image: var(--md-admonition-icon--quote);
+ mask-image: var(--md-admonition-icon--admonish-quote);
+ -webkit-mask-image: var(--md-admonition-icon--admonish-quote);
mask-repeat: no-repeat;
-webkit-mask-repeat: no-repeat;
mask-size: contain;
@@ -340,7 +334,8 @@ details[open].admonition > summary.admonition-title::after {
background-color: var(--sidebar-bg);
}
-.ayu :is(.admonition), .coal :is(.admonition) {
+.ayu :is(.admonition),
+.coal :is(.admonition) {
background-color: var(--theme-hover);
}
diff --git a/src/README.md b/src/README.md
index 5a5b4d4..b7db586 100644
--- a/src/README.md
+++ b/src/README.md
@@ -1,57 +1,3 @@
-
-
# Introduction
-Welcome to Sovereign Computing with Start9 Labs!
-
-## Third party plugins
-
-[External link to plugins](https://github.com/rust-lang/mdBook/wiki/Third-party-plugins)
-
-## TODO (if moving forward with mdbook)
-
-1. Outline edits & approval
-1. Add content
-1. Theming
-1. Deployment pipeline
-1. Publish
-1. Translations (ongoing)
-
-### Possible `mdbook` admonitions
-
-```admonish
-A note.
-```
-
-```admonish example
-An example.
-```
-```admonish info
-Some info on this thing.
-```
-
-```admonish tip
-Protip on this thing.
-```
-
-```admonish warning
-You don't want to do this!
-```
-
-```admonish bug
-Bonjour sucks, but it's gone now
-```
-
-```admonish danger
-WTF ARE YOU DOING?!
-```
-
-```admonish warning title="Custom, i.e. -> POSSIBLE DATA LOSS"
-The following steps can lead to irrecoverable data corruption.
-```
-
-```admonish success title=""
-Admonition without title - This will take a while, go and grab a sandwich.
-```
-
-And tons more -> https://tommilligan.github.io/mdbook-admonish/reference.html
\ No newline at end of file
+Welcome to Sovereign Computing with Start9 Labs!
diff --git a/src/SUMMARY.md b/src/SUMMARY.md
index 739b43d..78e7855 100644
--- a/src/SUMMARY.md
+++ b/src/SUMMARY.md
@@ -1,101 +1,94 @@
# Summary
+
[Introduction](README.md)
# User Manual
---
-- [Initial Setup](initial-setup.md)
-- [DIY](diy/README.md)
- - [X86_64](diy/x86_64.md)
- - [RasPi](diy/RasPi.md)
- - [ARM](diy/ARM.md)
-- [Device Guides](device-guides/README.md)
- - [Linux](device-guides/linux/README.md)
- - [LAN](device-guides/linux/linux-lan.md)
- - [VPN](device-guides/linux/linux-vpn.md)
- - [Domains](device-guides/linux/linux-domains.md)
- - [Tor](device-guides/linux/linux-tor.md)
- - [Browser config](device-guides/linux/linux-browser.md)
- - [Mac](device-guides/mac/README.md)
- - [LAN](device-guides/mac/mac-lan.md)
- - [VPN](device-guides/mac/mac-vpn.md)
- - [Domains](device-guides/mac/mac-domains.md)
- - [Tor](device-guides/mac/mac-tor.md)
- - [Browser config](device-guides/mac/mac-browser.md)
- - [Windows](device-guides/windows/README.md)
- - [LAN](device-guides/windows/windows-lan.md)
- - [VPN](device-guides/windows/windows-vpn.md)
- - [Domains](device-guides/windows/windows-domains.md)
- - [Tor](device-guides/windows/windows-tor.md)
- - [Browser config](device-guides/windows/windows-browser.md)
- - [Android](device-guides/android/README.md)
- - [LAN](device-guides/android/android-lan.md)
- - [VPN](device-guides/android/android-vpn.md)
- - [Domains](device-guides/android/android-domains.md)
- - [Tor](device-guides/android/android-tor.md)
- - [Browser config](device-guides/android/android-browser.md)
- - [iOS](device-guides/ios/README.md)
- - [LAN](device-guides/ios/ios-lan.md)
- - [VPN](device-guides/ios/ios-vpn.md)
- - [Domains](device-guides/ios/ios-domains.md)
- - [Tor](device-guides/ios/ios-tor.md)
- - [Browser config](device-guides/ios/ios-browser.md)
-- [Updates](updates.md)
-- [Backup & Restore](backups/README.md)
- - [Cloud](backups/backup-cloud.md)
- - [Remote](backups/backup-remote.md)
- - [Local Network](backups/backup-lan.md)
- - [Physical](backups/backup-physical.md)
- - [Restore from Backup](backups/restore/README.md)
- - [Restore](backups/restore/restore.md)
- - [Attach](backups/restore/attach.md)
- - [Recover](backups/restore/recover.md)
- - [Transfer](backups/restore/transfer.md)
- - [Hardware upgrades](backups/restore/upgrade-hardware.md)
-- [StartOS Walkthrough](walkthrough/README.md)
- - [Main UI](walkthrough/mainUI.md)
- - [Managing Services](walkthrough/services.md)
- - [Customization](walkthrough/customize.md)
- - [Session Management](walkthrough/sessions.md)
- - [WiFi & Bluetooth](walkthrough/wifi-bt.md)
- - [SSH](walkthrough/ssh.md)
- - [Marketplace](walkthrough/marketplace/README.md)
- - [Managing registries](walkthrough/marketplace/registries.md)
-- [Service guides](service-guides/README.md)
- - [Bitcoin](service-guides/bitcoin.md)
- - [Jellyfin](service-guides/jellyfin.md)
- - [Lightning](service-guides/lightning.md)
- - [Matrix](service-guides/matrix.md)
- - [Nextcloud](service-guides/nextcloud.md)
- - [Specter](service-guides/specter.md)
- - [Vaultwarden](service-guides/vaultwarden.md)
+- [Initial Setup](user-manual/initial-setup/README.md)
+ - [Starting Fresh](user-manual/initial-setup/start-fresh.md)
+ - [Using an Existing Drive](user-manual/initial-setup/use-existing.md)
+ - [Transferring Drives](user-manual/initial-setup/transfer.md)
+ - [Restoring from Backup](user-manual/initial-setup/restore-from-backup.md)
+- [Trusting Your Root CA](user-manual/trust-ca.md)
+- [Connecting](user-manual/connecting.md)
+- [Installing Services](user-manual/installing-services.md)
+- [Creating Backups](user-manual/backup-create.md)
+- [Restoring Backups](user-manual/backup-restore.md)
+- [Using SSH](user-manual/ssh.md)
+- [Using WiFi](user-manual/wifi.md)
+- [Updating StartOS](user-manual/updating-startos.md)
-# Support
+# Guides
---
-- [Start9 support channels](s9-support.md)
-- [External support channels](external-support.md)
-- [Troubleshooting](troubleshooting/README.md)
- - [Initial setup](troubleshooting/ts-inital-setup.md)
- - [Device connectivity](troubleshooting/ts-connectivity.md)
- - [Backups](troubleshooting/ts-backups.md)
- - [Reset your password](troubleshooting/ts-password-reset.md)
-- [Knowledgebase](knowledgebase/README.md)
- - [FAQ](knowledgebase/faq.md)
- - [Glossary](knowledgebase/gloassary.md)
- - [Concepts](knowledgebase/concepts.md)
+- [Device Guides](guides/device-guides/README.md)
+
+ - [Linux](guides/device-guides/linux/README.md)
+ - [Trusting Your Root CA](guides/device-guides/linux/linux-ca.md)
+ - [Connecting Over VPN](guides/device-guides/linux/linux-vpn.md)
+ - [Connecting Over Tor](guides/device-guides/linux/linux-tor.md)
+ - [Creating Backups](guides/device-guides/linux/linux-backups.md)
+ - [Mac](guides/device-guides/mac/README.md)
+ - [Trusting Your Root CA](guides/device-guides/mac/mac-ca.md)
+ - [Connecting Over VPN](guides/device-guides/mac/mac-vpn.md)
+ - [Connecting Over Tor](guides/device-guides/mac/mac-tor.md)
+ - [Creating Backups](guides/device-guides/mac/mac-backups.md)
+ - [Windows](guides/device-guides/windows/README.md)
+ - [Trusting Your Root CA](guides/device-guides/windows/windows-ca.md)
+ - [Connecting Over VPN](guides/device-guides/windows/windows-vpn.md)
+ - [Connecting Over Tor](guides/device-guides/windows/windows-tor.md)
+ - [Creating Backups](guides/device-guides/windows/windows-backups.md)
+ - [Android/Graphene](guides/device-guides/android/README.md)
+ - [Trusting Your Root CA](guides/device-guides/android/android-ca.md)
+ - [Connecting Over VPN](guides/device-guides/android/android-vpn.md)
+ - [Connecting Over Tor](guides/device-guides/android/android-tor.md)
+ - [iOS](guides/device-guides/ios/README.md)
+
+ - [Trusting Your Root CA](guides/device-guides/ios/ios-ca.md)
+ - [Connecting Over VPN](guides/device-guides/ios/ios-vpn.md)
+ - [Connecting Over Tor](guides/device-guides/ios/ios-tor.md)
+
+- [Browser Guides](guides/browser-guides/README.md)
+
+ - [Firefox](guides/browser-guides/firefox.md)
+ - [Chrome](guides/browser-guides/chrome.md)
+ - [Tor Browser](guides/browser-guides/tor-browser.md)
+
+- [Service Guides](guides/service-guides/README.md)
-# Developer Docs
+ - [Bitcoin](guides/service-guides/bitcoin.md)
+ - [CLN](guides/service-guides/cln.md)
+ - [Jellyfin](guides/service-guides/jellyfin.md)
+ - [LND](guides/service-guides/lnd.md)
+ - [Nextcloud](guides/service-guides/nextcloud.md)
+ - [SimpleX](guides/service-guides/simplex.md)
+ - [Synapse](guides/service-guides/synapse.md)
+ - [Vaultwarden](guides/service-guides/vaultwarden.md)
+
+- [Flashing Guides](guides/flashing-guides/README.md)
+
+ - [Firmware](guides/flashing-guides/firmware/README.md)
+
+ - [Server Pure (all years)](guides/flashing-guides/firmware/pure.md)
+ - [Server One (2023)](guides/flashing-guides/firmware/one-2023.md)
+
+ - [StartOS](guides/flashing-guides//startos/README.md)
+ - [X86_64](guides/flashing-guides/startos/x86_64.md)
+ - [Raspberry Pi](guides/flashing-guides/startos/pi.md)
+
+- [Miscellaneous Guides](guides/misc-guides/README.md)
+ - [Upgrading From a Raspberry Pi](guides/misc-guides/upgrade-pi.md)
+ - [Migrate LND to StartOS](guides/misc-guides/migrate-lnd.md)
+ - [Reset Password (Lost/Forgotten)](guides/misc-guides/reset-password.md)
+ - [Getting SMTP Credentials](guides/misc-guides/smtp-credentials.md)
+ - [Using Thunderbird](guides/misc-guides/using-thunderbird.md)
+
+# Support
---
-- [Contributing](contributing/README.md)
- - [StartOS](contributing/startos.md)
- - [Service packaging](contributing/service-packaging.md)
- - [Documentation](contributing/docs.md)
-- [StartOS Dev Tools](dev-tools.md)
-- [Package A Service](packaging-guide.md)
-- [Packaging Spec](packaging-spec.md)
-- [Submission Process](packaging-submissions.md)
+- [Common Issues](support/common-issues.md)
+- [Contact](support/contact.md)
diff --git a/src/android/browser.md b/src/android/browser.md
deleted file mode 100644
index 4660638..0000000
--- a/src/android/browser.md
+++ /dev/null
@@ -1 +0,0 @@
-# Browser config
diff --git a/src/android/domains.md b/src/android/domains.md
deleted file mode 100644
index d3a04da..0000000
--- a/src/android/domains.md
+++ /dev/null
@@ -1 +0,0 @@
-# Domains
diff --git a/src/android/lan.md b/src/android/lan.md
deleted file mode 100644
index 7a5171b..0000000
--- a/src/android/lan.md
+++ /dev/null
@@ -1 +0,0 @@
-# LAN
diff --git a/src/android/tor.md b/src/android/tor.md
deleted file mode 100644
index ee87db4..0000000
--- a/src/android/tor.md
+++ /dev/null
@@ -1 +0,0 @@
-# Tor
diff --git a/src/android/vpn.md b/src/android/vpn.md
deleted file mode 100644
index c45efc3..0000000
--- a/src/android/vpn.md
+++ /dev/null
@@ -1 +0,0 @@
-# VPN
diff --git a/src/assets/img/modernLogoWide.png b/src/assets/img/start9-light.png
similarity index 100%
rename from src/assets/img/modernLogoWide.png
rename to src/assets/img/start9-light.png
diff --git a/src/backups/README.md b/src/backups/README.md
deleted file mode 100644
index 299adae..0000000
--- a/src/backups/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# Backups
diff --git a/src/backups/backup-cloud.md b/src/backups/backup-cloud.md
deleted file mode 100644
index 3a6a4fa..0000000
--- a/src/backups/backup-cloud.md
+++ /dev/null
@@ -1 +0,0 @@
-# Cloud
diff --git a/src/backups/backup-lan.md b/src/backups/backup-lan.md
deleted file mode 100644
index e3cac43..0000000
--- a/src/backups/backup-lan.md
+++ /dev/null
@@ -1 +0,0 @@
-# Local Network
diff --git a/src/backups/backup-physical.md b/src/backups/backup-physical.md
deleted file mode 100644
index 9d72d79..0000000
--- a/src/backups/backup-physical.md
+++ /dev/null
@@ -1 +0,0 @@
-# Physical
diff --git a/src/backups/backup-remote.md b/src/backups/backup-remote.md
deleted file mode 100644
index f66608b..0000000
--- a/src/backups/backup-remote.md
+++ /dev/null
@@ -1 +0,0 @@
-# Remote
diff --git a/src/backups/restore/README.md b/src/backups/restore/README.md
deleted file mode 100644
index 16af592..0000000
--- a/src/backups/restore/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# Restore
diff --git a/src/backups/restore/attach.md b/src/backups/restore/attach.md
deleted file mode 100644
index b71b71a..0000000
--- a/src/backups/restore/attach.md
+++ /dev/null
@@ -1 +0,0 @@
-# Attach
diff --git a/src/backups/restore/recover.md b/src/backups/restore/recover.md
deleted file mode 100644
index 918ebfa..0000000
--- a/src/backups/restore/recover.md
+++ /dev/null
@@ -1 +0,0 @@
-# Recover
diff --git a/src/backups/restore/restore.md b/src/backups/restore/restore.md
deleted file mode 100644
index 185ec6f..0000000
--- a/src/backups/restore/restore.md
+++ /dev/null
@@ -1 +0,0 @@
-# Hardware upgrades
diff --git a/src/backups/restore/transfer.md b/src/backups/restore/transfer.md
deleted file mode 100644
index 0b5bbcf..0000000
--- a/src/backups/restore/transfer.md
+++ /dev/null
@@ -1 +0,0 @@
-# Transfer
diff --git a/src/backups/restore/upgrade-hardware.md b/src/backups/restore/upgrade-hardware.md
deleted file mode 100644
index 185ec6f..0000000
--- a/src/backups/restore/upgrade-hardware.md
+++ /dev/null
@@ -1 +0,0 @@
-# Hardware upgrades
diff --git a/src/connections/README.md b/src/connections/README.md
deleted file mode 100644
index daaba4e..0000000
--- a/src/connections/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# Connections
diff --git a/src/connections/lan/README.md b/src/connections/lan/README.md
deleted file mode 100644
index 412d047..0000000
--- a/src/connections/lan/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# LAN Guides
diff --git a/src/connections/lan/lan-linux.md b/src/connections/lan/lan-linux.md
deleted file mode 100644
index abc8b33..0000000
--- a/src/connections/lan/lan-linux.md
+++ /dev/null
@@ -1 +0,0 @@
-# Linux LAN
diff --git a/src/connections/tor/README.md b/src/connections/tor/README.md
deleted file mode 100644
index 2cac8e7..0000000
--- a/src/connections/tor/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# Tor Guides
diff --git a/src/connections/tor/tor-linux.md b/src/connections/tor/tor-linux.md
deleted file mode 100644
index ca1ba0a..0000000
--- a/src/connections/tor/tor-linux.md
+++ /dev/null
@@ -1 +0,0 @@
-# Linux Tor
diff --git a/src/contributing/README.md b/src/contributing/README.md
deleted file mode 100644
index 854139a..0000000
--- a/src/contributing/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# Contributing
diff --git a/src/contributing/docs.md b/src/contributing/docs.md
deleted file mode 100644
index 25f8d45..0000000
--- a/src/contributing/docs.md
+++ /dev/null
@@ -1 +0,0 @@
-# Documentation
diff --git a/src/contributing/service-packaging.md b/src/contributing/service-packaging.md
deleted file mode 100644
index 8151ec1..0000000
--- a/src/contributing/service-packaging.md
+++ /dev/null
@@ -1 +0,0 @@
-# Service packaging
diff --git a/src/contributing/startos.md b/src/contributing/startos.md
deleted file mode 100644
index 8576d2b..0000000
--- a/src/contributing/startos.md
+++ /dev/null
@@ -1 +0,0 @@
-# StartOS
diff --git a/src/dev-tools.md b/src/dev-tools.md
deleted file mode 100644
index 0c6a1d5..0000000
--- a/src/dev-tools.md
+++ /dev/null
@@ -1 +0,0 @@
-# StartOS dev tools
diff --git a/src/device-guides/README.md b/src/device-guides/README.md
deleted file mode 100644
index e7fd8e8..0000000
--- a/src/device-guides/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# Device Guides
diff --git a/src/device-guides/android/README.md b/src/device-guides/android/README.md
deleted file mode 100644
index f5aec8a..0000000
--- a/src/device-guides/android/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# Android
diff --git a/src/device-guides/android/android-browser.md b/src/device-guides/android/android-browser.md
deleted file mode 100644
index 4660638..0000000
--- a/src/device-guides/android/android-browser.md
+++ /dev/null
@@ -1 +0,0 @@
-# Browser config
diff --git a/src/device-guides/android/android-domains.md b/src/device-guides/android/android-domains.md
deleted file mode 100644
index d3a04da..0000000
--- a/src/device-guides/android/android-domains.md
+++ /dev/null
@@ -1 +0,0 @@
-# Domains
diff --git a/src/device-guides/android/android-lan.md b/src/device-guides/android/android-lan.md
deleted file mode 100644
index 7a5171b..0000000
--- a/src/device-guides/android/android-lan.md
+++ /dev/null
@@ -1 +0,0 @@
-# LAN
diff --git a/src/device-guides/android/android-tor.md b/src/device-guides/android/android-tor.md
deleted file mode 100644
index ee87db4..0000000
--- a/src/device-guides/android/android-tor.md
+++ /dev/null
@@ -1 +0,0 @@
-# Tor
diff --git a/src/device-guides/android/android-vpn.md b/src/device-guides/android/android-vpn.md
deleted file mode 100644
index c45efc3..0000000
--- a/src/device-guides/android/android-vpn.md
+++ /dev/null
@@ -1 +0,0 @@
-# VPN
diff --git a/src/device-guides/ios/README.md b/src/device-guides/ios/README.md
deleted file mode 100644
index dd74402..0000000
--- a/src/device-guides/ios/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# iOS
diff --git a/src/device-guides/ios/ios-browser.md b/src/device-guides/ios/ios-browser.md
deleted file mode 100644
index 4660638..0000000
--- a/src/device-guides/ios/ios-browser.md
+++ /dev/null
@@ -1 +0,0 @@
-# Browser config
diff --git a/src/device-guides/ios/ios-domains.md b/src/device-guides/ios/ios-domains.md
deleted file mode 100644
index d3a04da..0000000
--- a/src/device-guides/ios/ios-domains.md
+++ /dev/null
@@ -1 +0,0 @@
-# Domains
diff --git a/src/device-guides/ios/ios-lan.md b/src/device-guides/ios/ios-lan.md
deleted file mode 100644
index 7a5171b..0000000
--- a/src/device-guides/ios/ios-lan.md
+++ /dev/null
@@ -1 +0,0 @@
-# LAN
diff --git a/src/device-guides/ios/ios-tor.md b/src/device-guides/ios/ios-tor.md
deleted file mode 100644
index ee87db4..0000000
--- a/src/device-guides/ios/ios-tor.md
+++ /dev/null
@@ -1 +0,0 @@
-# Tor
diff --git a/src/device-guides/ios/ios-vpn.md b/src/device-guides/ios/ios-vpn.md
deleted file mode 100644
index c45efc3..0000000
--- a/src/device-guides/ios/ios-vpn.md
+++ /dev/null
@@ -1 +0,0 @@
-# VPN
diff --git a/src/device-guides/linux/README.md b/src/device-guides/linux/README.md
deleted file mode 100644
index f560039..0000000
--- a/src/device-guides/linux/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# Linux
diff --git a/src/device-guides/linux/linux-browser.md b/src/device-guides/linux/linux-browser.md
deleted file mode 100644
index 4660638..0000000
--- a/src/device-guides/linux/linux-browser.md
+++ /dev/null
@@ -1 +0,0 @@
-# Browser config
diff --git a/src/device-guides/linux/linux-domains.md b/src/device-guides/linux/linux-domains.md
deleted file mode 100644
index d3a04da..0000000
--- a/src/device-guides/linux/linux-domains.md
+++ /dev/null
@@ -1 +0,0 @@
-# Domains
diff --git a/src/device-guides/linux/linux-lan.md b/src/device-guides/linux/linux-lan.md
deleted file mode 100644
index 7a5171b..0000000
--- a/src/device-guides/linux/linux-lan.md
+++ /dev/null
@@ -1 +0,0 @@
-# LAN
diff --git a/src/device-guides/linux/linux-tor.md b/src/device-guides/linux/linux-tor.md
deleted file mode 100644
index ee87db4..0000000
--- a/src/device-guides/linux/linux-tor.md
+++ /dev/null
@@ -1 +0,0 @@
-# Tor
diff --git a/src/device-guides/linux/linux-vpn.md b/src/device-guides/linux/linux-vpn.md
deleted file mode 100644
index c45efc3..0000000
--- a/src/device-guides/linux/linux-vpn.md
+++ /dev/null
@@ -1 +0,0 @@
-# VPN
diff --git a/src/device-guides/mac/README.md b/src/device-guides/mac/README.md
deleted file mode 100644
index 87404e1..0000000
--- a/src/device-guides/mac/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# Mac
diff --git a/src/device-guides/mac/mac-browser.md b/src/device-guides/mac/mac-browser.md
deleted file mode 100644
index 4660638..0000000
--- a/src/device-guides/mac/mac-browser.md
+++ /dev/null
@@ -1 +0,0 @@
-# Browser config
diff --git a/src/device-guides/mac/mac-domains.md b/src/device-guides/mac/mac-domains.md
deleted file mode 100644
index d3a04da..0000000
--- a/src/device-guides/mac/mac-domains.md
+++ /dev/null
@@ -1 +0,0 @@
-# Domains
diff --git a/src/device-guides/mac/mac-lan.md b/src/device-guides/mac/mac-lan.md
deleted file mode 100644
index 7a5171b..0000000
--- a/src/device-guides/mac/mac-lan.md
+++ /dev/null
@@ -1 +0,0 @@
-# LAN
diff --git a/src/device-guides/mac/mac-tor.md b/src/device-guides/mac/mac-tor.md
deleted file mode 100644
index ee87db4..0000000
--- a/src/device-guides/mac/mac-tor.md
+++ /dev/null
@@ -1 +0,0 @@
-# Tor
diff --git a/src/device-guides/mac/mac-vpn.md b/src/device-guides/mac/mac-vpn.md
deleted file mode 100644
index c45efc3..0000000
--- a/src/device-guides/mac/mac-vpn.md
+++ /dev/null
@@ -1 +0,0 @@
-# VPN
diff --git a/src/device-guides/windows/README.md b/src/device-guides/windows/README.md
deleted file mode 100644
index af6fdce..0000000
--- a/src/device-guides/windows/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# Windows
diff --git a/src/device-guides/windows/windows-browser.md b/src/device-guides/windows/windows-browser.md
deleted file mode 100644
index 4660638..0000000
--- a/src/device-guides/windows/windows-browser.md
+++ /dev/null
@@ -1 +0,0 @@
-# Browser config
diff --git a/src/device-guides/windows/windows-domains.md b/src/device-guides/windows/windows-domains.md
deleted file mode 100644
index d3a04da..0000000
--- a/src/device-guides/windows/windows-domains.md
+++ /dev/null
@@ -1 +0,0 @@
-# Domains
diff --git a/src/device-guides/windows/windows-lan.md b/src/device-guides/windows/windows-lan.md
deleted file mode 100644
index 7a5171b..0000000
--- a/src/device-guides/windows/windows-lan.md
+++ /dev/null
@@ -1 +0,0 @@
-# LAN
diff --git a/src/device-guides/windows/windows-tor.md b/src/device-guides/windows/windows-tor.md
deleted file mode 100644
index ee87db4..0000000
--- a/src/device-guides/windows/windows-tor.md
+++ /dev/null
@@ -1 +0,0 @@
-# Tor
diff --git a/src/device-guides/windows/windows-vpn.md b/src/device-guides/windows/windows-vpn.md
deleted file mode 100644
index c45efc3..0000000
--- a/src/device-guides/windows/windows-vpn.md
+++ /dev/null
@@ -1 +0,0 @@
-# VPN
diff --git a/src/diy/ARM.md b/src/diy/ARM.md
deleted file mode 100644
index 039090f..0000000
--- a/src/diy/ARM.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# ARM DIY Recommendations
-
-## Flashing Guide
-
-## VM Install
\ No newline at end of file
diff --git a/src/diy/README.md b/src/diy/README.md
deleted file mode 100644
index dbefdeb..0000000
--- a/src/diy/README.md
+++ /dev/null
@@ -1,9 +0,0 @@
-# DIY
-1. Reasons to DIY
-
-2. Hardware options w/ Pros/Cons
-
-### Internal (ref) links
-- [x86_64](x86_64.md)
-- [RasPi](RasPi.md)
-- [ARM](ARM.md)
\ No newline at end of file
diff --git a/src/diy/RasPi.md b/src/diy/RasPi.md
deleted file mode 100644
index 1332675..0000000
--- a/src/diy/RasPi.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Raspberry Pi DIY Recommendations
-
-## Flashing Guide
-
-## VM Install
\ No newline at end of file
diff --git a/src/diy/x86_64.md b/src/diy/x86_64.md
deleted file mode 100644
index 0d34681..0000000
--- a/src/diy/x86_64.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# X86_64 DIY Recommendations
-
-## Flashing Guide
-
-## VM Install
\ No newline at end of file
diff --git a/src/external-support.md b/src/external-support.md
deleted file mode 100644
index 718ab52..0000000
--- a/src/external-support.md
+++ /dev/null
@@ -1 +0,0 @@
-# External support channels
diff --git a/src/guides/browser-guides/README.md b/src/guides/browser-guides/README.md
new file mode 100644
index 0000000..3282aef
--- /dev/null
+++ b/src/guides/browser-guides/README.md
@@ -0,0 +1,5 @@
+# Browser Guides
+
+- [Firefox](firefox.md)
+- [Chrome](chrome.md)
+- [Tor Browser](tor-browser.md)
diff --git a/src/guides/browser-guides/chrome.md b/src/guides/browser-guides/chrome.md
new file mode 100644
index 0000000..ca4e896
--- /dev/null
+++ b/src/guides/browser-guides/chrome.md
@@ -0,0 +1 @@
+# Chrome
diff --git a/src/guides/browser-guides/firefox.md b/src/guides/browser-guides/firefox.md
new file mode 100644
index 0000000..57852c3
--- /dev/null
+++ b/src/guides/browser-guides/firefox.md
@@ -0,0 +1 @@
+# Firefox
diff --git a/src/guides/browser-guides/tor-browser.md b/src/guides/browser-guides/tor-browser.md
new file mode 100644
index 0000000..8af9b19
--- /dev/null
+++ b/src/guides/browser-guides/tor-browser.md
@@ -0,0 +1 @@
+# Tor Browser
diff --git a/src/guides/device-guides/README.md b/src/guides/device-guides/README.md
new file mode 100644
index 0000000..f98e599
--- /dev/null
+++ b/src/guides/device-guides/README.md
@@ -0,0 +1,12 @@
+# Device Guides
+
+## Laptop/Desktop
+
+- [Linux](linux)
+- [Mac](mac)
+- [Windows](windows)
+
+## Mobile
+
+- [Android/Graphene](android)
+- [iOS](ios)
diff --git a/src/guides/device-guides/android/README.md b/src/guides/device-guides/android/README.md
new file mode 100644
index 0000000..8bf9a69
--- /dev/null
+++ b/src/guides/device-guides/android/README.md
@@ -0,0 +1,5 @@
+# Android/Graphene Guides
+
+- [Trusting Your Root CA](android-ca.md)
+- [Connecting Over VPN](android-vpn.md)
+- [Connecting Over Tor](android-tor.md)
diff --git a/src/guides/device-guides/android/android-ca.md b/src/guides/device-guides/android/android-ca.md
new file mode 100644
index 0000000..953dbbe
--- /dev/null
+++ b/src/guides/device-guides/android/android-ca.md
@@ -0,0 +1 @@
+# Trusting Your Root CA (Android/Graphene)
diff --git a/src/guides/device-guides/android/android-tor.md b/src/guides/device-guides/android/android-tor.md
new file mode 100644
index 0000000..f1c25c6
--- /dev/null
+++ b/src/guides/device-guides/android/android-tor.md
@@ -0,0 +1 @@
+# Connecting Over Tor (Android/Graphene)
diff --git a/src/guides/device-guides/android/android-vpn.md b/src/guides/device-guides/android/android-vpn.md
new file mode 100644
index 0000000..769bfb3
--- /dev/null
+++ b/src/guides/device-guides/android/android-vpn.md
@@ -0,0 +1 @@
+# Connecting Over VPN (Android/Graphene)
diff --git a/src/guides/device-guides/ios/README.md b/src/guides/device-guides/ios/README.md
new file mode 100644
index 0000000..6dc39dd
--- /dev/null
+++ b/src/guides/device-guides/ios/README.md
@@ -0,0 +1,5 @@
+# iOS Guides
+
+- [Trusting Your Root CA](ios-ca.md)
+- [Connecting Over VPN](ios-vpn.md)
+- [Connecting Over Tor](ios-tor.md)
diff --git a/src/guides/device-guides/ios/ios-ca.md b/src/guides/device-guides/ios/ios-ca.md
new file mode 100644
index 0000000..4f37873
--- /dev/null
+++ b/src/guides/device-guides/ios/ios-ca.md
@@ -0,0 +1 @@
+# Trusting Your Root CA (iOS)
diff --git a/src/guides/device-guides/ios/ios-tor.md b/src/guides/device-guides/ios/ios-tor.md
new file mode 100644
index 0000000..cd3fda8
--- /dev/null
+++ b/src/guides/device-guides/ios/ios-tor.md
@@ -0,0 +1 @@
+# Connecting Over Tor (iOS)
diff --git a/src/guides/device-guides/ios/ios-vpn.md b/src/guides/device-guides/ios/ios-vpn.md
new file mode 100644
index 0000000..39e3a5f
--- /dev/null
+++ b/src/guides/device-guides/ios/ios-vpn.md
@@ -0,0 +1 @@
+# Connecting Over VPN (iOS)
diff --git a/src/guides/device-guides/linux/README.md b/src/guides/device-guides/linux/README.md
new file mode 100644
index 0000000..96e035b
--- /dev/null
+++ b/src/guides/device-guides/linux/README.md
@@ -0,0 +1,6 @@
+# Linux Guides
+
+- [Trusting Your Root CA](linux-ca.md)
+- [Connecting Over VPN](linux-vpn.md)
+- [Connecting Over Tor](linux-tor.md)
+- [Creating Backups](linux-backups.md)
diff --git a/src/guides/device-guides/linux/linux-backups.md b/src/guides/device-guides/linux/linux-backups.md
new file mode 100644
index 0000000..1670dbf
--- /dev/null
+++ b/src/guides/device-guides/linux/linux-backups.md
@@ -0,0 +1 @@
+# Creating Backups (Linux)
diff --git a/src/guides/device-guides/linux/linux-ca.md b/src/guides/device-guides/linux/linux-ca.md
new file mode 100644
index 0000000..f2d837c
--- /dev/null
+++ b/src/guides/device-guides/linux/linux-ca.md
@@ -0,0 +1 @@
+# Trusting Your Root CA (Linux)
diff --git a/src/guides/device-guides/linux/linux-tor.md b/src/guides/device-guides/linux/linux-tor.md
new file mode 100644
index 0000000..d363e75
--- /dev/null
+++ b/src/guides/device-guides/linux/linux-tor.md
@@ -0,0 +1 @@
+# Connecting Over Tor (Linux)
diff --git a/src/guides/device-guides/linux/linux-vpn.md b/src/guides/device-guides/linux/linux-vpn.md
new file mode 100644
index 0000000..8606c42
--- /dev/null
+++ b/src/guides/device-guides/linux/linux-vpn.md
@@ -0,0 +1 @@
+# Connecting Over VPN (Linux)
diff --git a/src/guides/device-guides/mac/README.md b/src/guides/device-guides/mac/README.md
new file mode 100644
index 0000000..b488a3c
--- /dev/null
+++ b/src/guides/device-guides/mac/README.md
@@ -0,0 +1,6 @@
+# Mac Guides
+
+- [Trusting Your Root CA](mac-ca.md)
+- [Connecting Over VPN](mac-vpn.md)
+- [Connecting Over Tor](mac-tor.md)
+- [Creating Backups](mac-backups.md)
diff --git a/src/guides/device-guides/mac/mac-backups.md b/src/guides/device-guides/mac/mac-backups.md
new file mode 100644
index 0000000..76f6b87
--- /dev/null
+++ b/src/guides/device-guides/mac/mac-backups.md
@@ -0,0 +1 @@
+# Creating Backups (Mac)
diff --git a/src/guides/device-guides/mac/mac-ca.md b/src/guides/device-guides/mac/mac-ca.md
new file mode 100644
index 0000000..736a65a
--- /dev/null
+++ b/src/guides/device-guides/mac/mac-ca.md
@@ -0,0 +1 @@
+# Trusting Your Root CA (Mac)
diff --git a/src/guides/device-guides/mac/mac-tor.md b/src/guides/device-guides/mac/mac-tor.md
new file mode 100644
index 0000000..d5ef97a
--- /dev/null
+++ b/src/guides/device-guides/mac/mac-tor.md
@@ -0,0 +1 @@
+# Connecting Over Tor ()
diff --git a/src/guides/device-guides/mac/mac-vpn.md b/src/guides/device-guides/mac/mac-vpn.md
new file mode 100644
index 0000000..4469319
--- /dev/null
+++ b/src/guides/device-guides/mac/mac-vpn.md
@@ -0,0 +1 @@
+# Connecting Over VPN (Mac)
diff --git a/src/guides/device-guides/windows/README.md b/src/guides/device-guides/windows/README.md
new file mode 100644
index 0000000..91c26a9
--- /dev/null
+++ b/src/guides/device-guides/windows/README.md
@@ -0,0 +1,6 @@
+# Windows Guides
+
+- [Trusting Your Root CA](windows-ca.md)
+- [Connecting Over VPN](windows-vpn.md)
+- [Connecting Over Tor](windows-tor.md)
+- [Creating Backups](windows-backups.md)
diff --git a/src/guides/device-guides/windows/windows-backups.md b/src/guides/device-guides/windows/windows-backups.md
new file mode 100644
index 0000000..6a54ab3
--- /dev/null
+++ b/src/guides/device-guides/windows/windows-backups.md
@@ -0,0 +1 @@
+# Creating Backups (Windows)
diff --git a/src/guides/device-guides/windows/windows-ca.md b/src/guides/device-guides/windows/windows-ca.md
new file mode 100644
index 0000000..8f04200
--- /dev/null
+++ b/src/guides/device-guides/windows/windows-ca.md
@@ -0,0 +1 @@
+# Trusting Your Root CA (Windows)
diff --git a/src/guides/device-guides/windows/windows-tor.md b/src/guides/device-guides/windows/windows-tor.md
new file mode 100644
index 0000000..4b9eb85
--- /dev/null
+++ b/src/guides/device-guides/windows/windows-tor.md
@@ -0,0 +1 @@
+# Connecting Over Tor (Windows)
diff --git a/src/guides/device-guides/windows/windows-vpn.md b/src/guides/device-guides/windows/windows-vpn.md
new file mode 100644
index 0000000..432b1f5
--- /dev/null
+++ b/src/guides/device-guides/windows/windows-vpn.md
@@ -0,0 +1 @@
+# Connecting Over VPN (Windows)
diff --git a/src/guides/flashing-guides/README.md b/src/guides/flashing-guides/README.md
new file mode 100644
index 0000000..6fbe534
--- /dev/null
+++ b/src/guides/flashing-guides/README.md
@@ -0,0 +1,4 @@
+# Flashing Guides
+
+- [Firmware](firmware)
+- [StartOS](startos)
diff --git a/src/guides/flashing-guides/firmware/README.md b/src/guides/flashing-guides/firmware/README.md
new file mode 100644
index 0000000..c1bd1a4
--- /dev/null
+++ b/src/guides/flashing-guides/firmware/README.md
@@ -0,0 +1,4 @@
+# Flashing Firmware
+
+- [Server-Pure (all years)](pure.md)
+- [Server One (2023)](one-2023.md)
diff --git a/src/guides/flashing-guides/firmware/one-2023.md b/src/guides/flashing-guides/firmware/one-2023.md
new file mode 100644
index 0000000..85628c3
--- /dev/null
+++ b/src/guides/flashing-guides/firmware/one-2023.md
@@ -0,0 +1 @@
+# Flashing Firmware - Server One (2023)
diff --git a/src/guides/flashing-guides/firmware/pure.md b/src/guides/flashing-guides/firmware/pure.md
new file mode 100644
index 0000000..0caea5a
--- /dev/null
+++ b/src/guides/flashing-guides/firmware/pure.md
@@ -0,0 +1 @@
+# Flashing Firmware - Server Pure (all years)
diff --git a/src/guides/flashing-guides/startos/README.md b/src/guides/flashing-guides/startos/README.md
new file mode 100644
index 0000000..8e1e5ec
--- /dev/null
+++ b/src/guides/flashing-guides/startos/README.md
@@ -0,0 +1,4 @@
+# Flashing StartOS
+
+- [x86_64](x86_64.md)
+- [Raspberry Pi](pi.md)
diff --git a/src/guides/flashing-guides/startos/pi.md b/src/guides/flashing-guides/startos/pi.md
new file mode 100644
index 0000000..9f5dbf5
--- /dev/null
+++ b/src/guides/flashing-guides/startos/pi.md
@@ -0,0 +1 @@
+# Flashing StartOS - Raspberry Pi
diff --git a/src/guides/flashing-guides/startos/x86_64.md b/src/guides/flashing-guides/startos/x86_64.md
new file mode 100644
index 0000000..9dcfb8e
--- /dev/null
+++ b/src/guides/flashing-guides/startos/x86_64.md
@@ -0,0 +1 @@
+# X86_64
diff --git a/src/guides/misc-guides/README.md b/src/guides/misc-guides/README.md
new file mode 100644
index 0000000..47688df
--- /dev/null
+++ b/src/guides/misc-guides/README.md
@@ -0,0 +1,9 @@
+# Miscellaneous Guides
+
+- [Initial Setup - Use Existing Drive](initial-setup-existing.md)
+- [Initial Setup - Transfer Drives](initial-setup-transfer.md)
+- [Upgrade From a Raspberry Pi](upgrade-pi.md)
+- [Migrate LND to StartOS](migrate-lnd.md)
+- [Reset Password (Lost/Forgotten)](reset-password.md)
+- [Getting SMTP Credentials](smtp-credentials.md)
+- [Using Thunderbird](using-thunderbird.md)
diff --git a/src/guides/misc-guides/migrate-lnd.md b/src/guides/misc-guides/migrate-lnd.md
new file mode 100644
index 0000000..6b79919
--- /dev/null
+++ b/src/guides/misc-guides/migrate-lnd.md
@@ -0,0 +1 @@
+# Migrate LND to StartOS
diff --git a/src/guides/misc-guides/reset-password.md b/src/guides/misc-guides/reset-password.md
new file mode 100644
index 0000000..81dea8d
--- /dev/null
+++ b/src/guides/misc-guides/reset-password.md
@@ -0,0 +1 @@
+# Reset Password (Lost/Forgotten)
diff --git a/src/guides/misc-guides/smtp-credentials.md b/src/guides/misc-guides/smtp-credentials.md
new file mode 100644
index 0000000..9a4631b
--- /dev/null
+++ b/src/guides/misc-guides/smtp-credentials.md
@@ -0,0 +1 @@
+# Getting SMTP Credentials
diff --git a/src/guides/misc-guides/upgrade-pi.md b/src/guides/misc-guides/upgrade-pi.md
new file mode 100644
index 0000000..3608805
--- /dev/null
+++ b/src/guides/misc-guides/upgrade-pi.md
@@ -0,0 +1 @@
+# Upgrade Your Raspberry Pi
diff --git a/src/guides/misc-guides/using-thunderbird.md b/src/guides/misc-guides/using-thunderbird.md
new file mode 100644
index 0000000..39fad39
--- /dev/null
+++ b/src/guides/misc-guides/using-thunderbird.md
@@ -0,0 +1 @@
+# Using Thunderbird
diff --git a/src/guides/service-guides/README.md b/src/guides/service-guides/README.md
new file mode 100644
index 0000000..1cf7af8
--- /dev/null
+++ b/src/guides/service-guides/README.md
@@ -0,0 +1,21 @@
+# Service Guides
+
+## Bitcoin
+
+- [Bitcoin](bitcoin.md)
+
+## Lightning
+
+- [Core Lightning (CLN)](cln.md)
+- [Lightning Network Daemon(LND)](lnd.md)
+
+## Messaging
+
+- [SimpleX](simplex.md)
+- [Synapse](synapse.md)
+
+## Data
+
+- [Jellyfin](jellyfin.md)
+- [Nextcloud](nextcloud.md)
+- [Vaultwarden](vaultwarden.md)
diff --git a/src/service-guides/bitcoin.md b/src/guides/service-guides/bitcoin.md
similarity index 100%
rename from src/service-guides/bitcoin.md
rename to src/guides/service-guides/bitcoin.md
diff --git a/src/guides/service-guides/cln.md b/src/guides/service-guides/cln.md
new file mode 100644
index 0000000..9217a14
--- /dev/null
+++ b/src/guides/service-guides/cln.md
@@ -0,0 +1 @@
+# Core Lightning (CLN)
diff --git a/src/service-guides/jellyfin.md b/src/guides/service-guides/jellyfin.md
similarity index 100%
rename from src/service-guides/jellyfin.md
rename to src/guides/service-guides/jellyfin.md
diff --git a/src/guides/service-guides/lnd.md b/src/guides/service-guides/lnd.md
new file mode 100644
index 0000000..437fc1e
--- /dev/null
+++ b/src/guides/service-guides/lnd.md
@@ -0,0 +1 @@
+# Lightning Network Daemon (LND)
diff --git a/src/service-guides/nextcloud.md b/src/guides/service-guides/nextcloud.md
similarity index 100%
rename from src/service-guides/nextcloud.md
rename to src/guides/service-guides/nextcloud.md
diff --git a/src/guides/service-guides/simplex.md b/src/guides/service-guides/simplex.md
new file mode 100644
index 0000000..5d6ab38
--- /dev/null
+++ b/src/guides/service-guides/simplex.md
@@ -0,0 +1 @@
+# SimpleX
diff --git a/src/guides/service-guides/synapse.md b/src/guides/service-guides/synapse.md
new file mode 100644
index 0000000..a055664
--- /dev/null
+++ b/src/guides/service-guides/synapse.md
@@ -0,0 +1 @@
+# Synapse
diff --git a/src/service-guides/vaultwarden.md b/src/guides/service-guides/vaultwarden.md
similarity index 100%
rename from src/service-guides/vaultwarden.md
rename to src/guides/service-guides/vaultwarden.md
diff --git a/src/initial-setup.md b/src/initial-setup.md
deleted file mode 100644
index ddf7b1f..0000000
--- a/src/initial-setup.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Initial Setup
-
-## Headless Mode
-
-## Kiosk Mode
diff --git a/src/knowledgebase/README.md b/src/knowledgebase/README.md
deleted file mode 100644
index 18c6905..0000000
--- a/src/knowledgebase/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# Knowledgebase
diff --git a/src/knowledgebase/concepts.md b/src/knowledgebase/concepts.md
deleted file mode 100644
index 74d42e1..0000000
--- a/src/knowledgebase/concepts.md
+++ /dev/null
@@ -1 +0,0 @@
-# Concepts
diff --git a/src/knowledgebase/faq.md b/src/knowledgebase/faq.md
deleted file mode 100644
index 4514b4c..0000000
--- a/src/knowledgebase/faq.md
+++ /dev/null
@@ -1 +0,0 @@
-# FAQ
diff --git a/src/knowledgebase/gloassary.md b/src/knowledgebase/gloassary.md
deleted file mode 100644
index ca3c827..0000000
--- a/src/knowledgebase/gloassary.md
+++ /dev/null
@@ -1 +0,0 @@
-# Glossary
diff --git a/src/packaging-guide.md b/src/packaging-guide.md
deleted file mode 100644
index 634e7b4..0000000
--- a/src/packaging-guide.md
+++ /dev/null
@@ -1 +0,0 @@
-# Package a service
diff --git a/src/packaging-spec.md b/src/packaging-spec.md
deleted file mode 100644
index a3ed34c..0000000
--- a/src/packaging-spec.md
+++ /dev/null
@@ -1 +0,0 @@
-# Packaging spec
diff --git a/src/packaging-submissions.md b/src/packaging-submissions.md
deleted file mode 100644
index 5df2704..0000000
--- a/src/packaging-submissions.md
+++ /dev/null
@@ -1 +0,0 @@
-# Submission process
diff --git a/src/s9-support.md b/src/s9-support.md
deleted file mode 100644
index 83972d2..0000000
--- a/src/s9-support.md
+++ /dev/null
@@ -1 +0,0 @@
-# Start9 support channels
diff --git a/src/service-guides/README.md b/src/service-guides/README.md
deleted file mode 100644
index 9d9b7fc..0000000
--- a/src/service-guides/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# Service guides
diff --git a/src/service-guides/lightning.md b/src/service-guides/lightning.md
deleted file mode 100644
index 42d9dcb..0000000
--- a/src/service-guides/lightning.md
+++ /dev/null
@@ -1 +0,0 @@
-# Lightning
diff --git a/src/service-guides/matrix.md b/src/service-guides/matrix.md
deleted file mode 100644
index f417dac..0000000
--- a/src/service-guides/matrix.md
+++ /dev/null
@@ -1 +0,0 @@
-# Matrix
diff --git a/src/service-guides/specter.md b/src/service-guides/specter.md
deleted file mode 100644
index 6f85042..0000000
--- a/src/service-guides/specter.md
+++ /dev/null
@@ -1 +0,0 @@
-# Specter
diff --git a/src/support/common-issues.md b/src/support/common-issues.md
new file mode 100644
index 0000000..d916a0f
--- /dev/null
+++ b/src/support/common-issues.md
@@ -0,0 +1 @@
+# Common Issues
diff --git a/src/support/contact.md b/src/support/contact.md
new file mode 100644
index 0000000..09f7129
--- /dev/null
+++ b/src/support/contact.md
@@ -0,0 +1 @@
+# Contact
diff --git a/src/troubleshooting/README.md b/src/troubleshooting/README.md
deleted file mode 100644
index 4f34127..0000000
--- a/src/troubleshooting/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# Troubleshooting
diff --git a/src/troubleshooting/ts-backups.md b/src/troubleshooting/ts-backups.md
deleted file mode 100644
index 299adae..0000000
--- a/src/troubleshooting/ts-backups.md
+++ /dev/null
@@ -1 +0,0 @@
-# Backups
diff --git a/src/troubleshooting/ts-connectivity.md b/src/troubleshooting/ts-connectivity.md
deleted file mode 100644
index 7d6dc4e..0000000
--- a/src/troubleshooting/ts-connectivity.md
+++ /dev/null
@@ -1 +0,0 @@
-# Device connectivity
diff --git a/src/troubleshooting/ts-inital-setup.md b/src/troubleshooting/ts-inital-setup.md
deleted file mode 100644
index 82ff7b9..0000000
--- a/src/troubleshooting/ts-inital-setup.md
+++ /dev/null
@@ -1 +0,0 @@
-# Initial setup
diff --git a/src/troubleshooting/ts-password-reset.md b/src/troubleshooting/ts-password-reset.md
deleted file mode 100644
index cfbdca5..0000000
--- a/src/troubleshooting/ts-password-reset.md
+++ /dev/null
@@ -1 +0,0 @@
-# Reset your password
diff --git a/src/updates.md b/src/updates.md
deleted file mode 100644
index 35d0173..0000000
--- a/src/updates.md
+++ /dev/null
@@ -1 +0,0 @@
-# Updates
diff --git a/src/user-manual/assets/ca-download-address-info.png b/src/user-manual/assets/ca-download-address-info.png
new file mode 100644
index 0000000..6d47480
Binary files /dev/null and b/src/user-manual/assets/ca-download-address-info.png differ
diff --git a/src/user-manual/assets/ca-download-login.png b/src/user-manual/assets/ca-download-login.png
new file mode 100644
index 0000000..c0d5395
Binary files /dev/null and b/src/user-manual/assets/ca-download-login.png differ
diff --git a/src/user-manual/assets/ca-download-setup.jpg b/src/user-manual/assets/ca-download-setup.jpg
new file mode 100644
index 0000000..d1d8854
Binary files /dev/null and b/src/user-manual/assets/ca-download-setup.jpg differ
diff --git a/src/user-manual/assets/ca-download-system.png b/src/user-manual/assets/ca-download-system.png
new file mode 100644
index 0000000..a02a63e
Binary files /dev/null and b/src/user-manual/assets/ca-download-system.png differ
diff --git a/src/user-manual/assets/registries.png b/src/user-manual/assets/registries.png
new file mode 100644
index 0000000..5c60a0c
Binary files /dev/null and b/src/user-manual/assets/registries.png differ
diff --git a/src/user-manual/assets/restore-decrypt.png b/src/user-manual/assets/restore-decrypt.png
new file mode 100644
index 0000000..ea543d0
Binary files /dev/null and b/src/user-manual/assets/restore-decrypt.png differ
diff --git a/src/user-manual/assets/restore-select-drive.png b/src/user-manual/assets/restore-select-drive.png
new file mode 100644
index 0000000..ac5dee8
Binary files /dev/null and b/src/user-manual/assets/restore-select-drive.png differ
diff --git a/src/user-manual/assets/restore-select-services.png b/src/user-manual/assets/restore-select-services.png
new file mode 100644
index 0000000..ef7a903
Binary files /dev/null and b/src/user-manual/assets/restore-select-services.png differ
diff --git a/src/user-manual/assets/sideload.png b/src/user-manual/assets/sideload.png
new file mode 100644
index 0000000..0389b94
Binary files /dev/null and b/src/user-manual/assets/sideload.png differ
diff --git a/src/user-manual/assets/system-restore.png b/src/user-manual/assets/system-restore.png
new file mode 100644
index 0000000..223045a
Binary files /dev/null and b/src/user-manual/assets/system-restore.png differ
diff --git a/src/user-manual/assets/system-sideload.png b/src/user-manual/assets/system-sideload.png
new file mode 100644
index 0000000..559d469
Binary files /dev/null and b/src/user-manual/assets/system-sideload.png differ
diff --git a/src/user-manual/backup-create.md b/src/user-manual/backup-create.md
new file mode 100644
index 0000000..b8261a2
--- /dev/null
+++ b/src/user-manual/backup-create.md
@@ -0,0 +1,49 @@
+# Creating Backups
+
+```admonish tip title="Important"
+Creating backups is an essential responsibility of self-hosting. If you do not make backups, you will eventually lose your data.
+```
+
+**Contents**
+
+- [What You Need to Know](#what-you-need-to-know)
+- [Physical Drive](#physical-drive)
+- [Network Folder](#network-folder)
+
+## What You Need to Know
+
+1. You can create backups to a [physical drive](#physical-drive) plugged directly into your server, or over-the-air to another device on the same LAN (a [network folder](#network-folder)).
+
+1. Backups are encrypted using your master password.
+
+1. Services may choose to exclude certain files or folders from the backup. For example, Bitcoin excludes the blockchain, since it can be recovered by re-syncing.
+
+1. Backups can take minutes or hours to complete, depending on your hardware and quantity of data.
+
+1. A service cannot be used while it is backing up. You may, however, continue to use your server and other services.
+
+1. Upon completion, StartOS issues a backup report, indicating which services were backed up, as well as any errors.
+
+## Physical Drive
+
+`EXT4` is the recommended format of your backup drive. `fat32` and `exFAT` are _not_ recommended and may not work.
+
+```admonish danger
+Backing up to USB thumb drive or SD card media is highly discouraged, as low-quality flash memory is easily corruptible.
+
+If you are using a Raspberry Pi, backup drive _must_ be self-powered, or be connected via a powered USB hub, to prevent possible data corruption.
+```
+
+## Network Folder
+
+Choose your target device below for instructions creating a network folder.
+
+- [Linux]()
+
+- [Mac]()
+
+- [Windows]()
+
+- [Synology]()
+
+- [TrueNAS]()
diff --git a/src/user-manual/backup-restore.md b/src/user-manual/backup-restore.md
new file mode 100644
index 0000000..47afd0f
--- /dev/null
+++ b/src/user-manual/backup-restore.md
@@ -0,0 +1,30 @@
+# Restoring Backups
+
+**Contents**
+
+1. [Restoring Individual Services](#restoring-individual-services)
+1. [Restoring an Entire Server](#restoring-an-entire-server)
+
+## Restoring Individual Services
+
+This option should only be necessary if you accidentally uninstall a service.
+
+1. Go to System > Restore From Backup.
+
+ 
+
+1. Select your backup drive.
+
+ 
+
+1. Decrypt the backup drive by entering the password that was used to create it.
+
+ 
+
+1. Select the service(s) you want to restore and click "Restore Selected".
+
+ 
+
+## Restoring an Entire Server
+
+If your StartOS data drive is lost or corrupted and you need to restore your entire server, follow instructions [here](./initial-setup/restore-from-backup.md).
diff --git a/src/user-manual/connecting.md b/src/user-manual/connecting.md
new file mode 100644
index 0000000..6cb42a4
--- /dev/null
+++ b/src/user-manual/connecting.md
@@ -0,0 +1,30 @@
+# Connecting To Your Server
+
+**Contents**
+
+1. [Connecting Locally](#connecting-locally)
+1. [Using a Router VPN](#connecting-with-a-router-vpn)
+1. [Using Tor](#connecting-with-tor)
+
+## Connecting Locally
+
+When connected to the same Local Area Network (LAN) as your server, visit your unique `https://.local` URL from any browser. Local connections are the fastest possible, no Internet connection required.
+
+If you are experiencing issues connecting locally, click [here]().
+
+## Connecting With a Router VPN
+
+Most modern routers have VPN functionality built-in. Refer to your router's manual or one of the guides below for instructions.
+
+## Connecting With Tor
+
+```admonish warning
+It is normal for Tor connections to be slow or unreliable at times.
+```
+
+You can connect to your server from anywhere in the world, privately and anonymously, by visiting its unique `http://....onion` URL from any Tor-enabled browser.
+
+**Recommended Browsers**
+
+- Linux, Mac, Windows, Android: Tor Browser
+- iOS: Onion Browser
diff --git a/src/user-manual/initial-setup/README.md b/src/user-manual/initial-setup/README.md
new file mode 100644
index 0000000..aaee7cf
--- /dev/null
+++ b/src/user-manual/initial-setup/README.md
@@ -0,0 +1,14 @@
+# Initial Setup
+
+1. Connect your server to power and Ethernet.
+
+1. From a computer connected to the same Local Area Network (LAN) as your server, open a browser and visit http://start.local.
+
+1. Select your setup:
+
+- [Starting Fresh](start-fresh.md)
+- [Using an Existing Drive](use-existing.md)
+- [Transferring Drives](transfer.md)
+- [Restoring from Backup](restore-from-backup.md)
+
+
diff --git a/src/user-manual/initial-setup/assets/complete.jpg b/src/user-manual/initial-setup/assets/complete.jpg
new file mode 100644
index 0000000..f52d8a2
Binary files /dev/null and b/src/user-manual/initial-setup/assets/complete.jpg differ
diff --git a/src/user-manual/initial-setup/assets/drive-select.jpg b/src/user-manual/initial-setup/assets/drive-select.jpg
new file mode 100644
index 0000000..f0008f9
Binary files /dev/null and b/src/user-manual/initial-setup/assets/drive-select.jpg differ
diff --git a/src/user-manual/initial-setup/assets/initializing.jpg b/src/user-manual/initial-setup/assets/initializing.jpg
new file mode 100644
index 0000000..f978bc0
Binary files /dev/null and b/src/user-manual/initial-setup/assets/initializing.jpg differ
diff --git a/src/user-manual/initial-setup/assets/password-set.jpg b/src/user-manual/initial-setup/assets/password-set.jpg
new file mode 100644
index 0000000..7d7dce0
Binary files /dev/null and b/src/user-manual/initial-setup/assets/password-set.jpg differ
diff --git a/src/user-manual/initial-setup/assets/recover-copy-progress.png b/src/user-manual/initial-setup/assets/recover-copy-progress.png
new file mode 100644
index 0000000..ef3b4e7
Binary files /dev/null and b/src/user-manual/initial-setup/assets/recover-copy-progress.png differ
diff --git a/src/user-manual/initial-setup/assets/recover-existing-select.jpg b/src/user-manual/initial-setup/assets/recover-existing-select.jpg
new file mode 100644
index 0000000..4dd8fe5
Binary files /dev/null and b/src/user-manual/initial-setup/assets/recover-existing-select.jpg differ
diff --git a/src/user-manual/initial-setup/assets/recover-existing.jpg b/src/user-manual/initial-setup/assets/recover-existing.jpg
new file mode 100644
index 0000000..3f1fd4f
Binary files /dev/null and b/src/user-manual/initial-setup/assets/recover-existing.jpg differ
diff --git a/src/user-manual/initial-setup/assets/recover-restore-decrypt.png b/src/user-manual/initial-setup/assets/recover-restore-decrypt.png
new file mode 100644
index 0000000..6464d96
Binary files /dev/null and b/src/user-manual/initial-setup/assets/recover-restore-decrypt.png differ
diff --git a/src/user-manual/initial-setup/assets/recover-restore-drive.png b/src/user-manual/initial-setup/assets/recover-restore-drive.png
new file mode 100644
index 0000000..62012db
Binary files /dev/null and b/src/user-manual/initial-setup/assets/recover-restore-drive.png differ
diff --git a/src/user-manual/initial-setup/assets/recover-restore.png b/src/user-manual/initial-setup/assets/recover-restore.png
new file mode 100644
index 0000000..5526138
Binary files /dev/null and b/src/user-manual/initial-setup/assets/recover-restore.png differ
diff --git a/src/user-manual/initial-setup/assets/recover-transfer-calc.png b/src/user-manual/initial-setup/assets/recover-transfer-calc.png
new file mode 100644
index 0000000..72b99e3
Binary files /dev/null and b/src/user-manual/initial-setup/assets/recover-transfer-calc.png differ
diff --git a/src/user-manual/initial-setup/assets/recover-transfer-from.png b/src/user-manual/initial-setup/assets/recover-transfer-from.png
new file mode 100644
index 0000000..7f28f58
Binary files /dev/null and b/src/user-manual/initial-setup/assets/recover-transfer-from.png differ
diff --git a/src/user-manual/initial-setup/assets/recover-transfer.png b/src/user-manual/initial-setup/assets/recover-transfer.png
new file mode 100644
index 0000000..79010cc
Binary files /dev/null and b/src/user-manual/initial-setup/assets/recover-transfer.png differ
diff --git a/src/user-manual/initial-setup/assets/recover.jpg b/src/user-manual/initial-setup/assets/recover.jpg
new file mode 100644
index 0000000..fa30395
Binary files /dev/null and b/src/user-manual/initial-setup/assets/recover.jpg differ
diff --git a/src/user-manual/initial-setup/assets/setup.jpg b/src/user-manual/initial-setup/assets/setup.jpg
new file mode 100644
index 0000000..64cdde0
Binary files /dev/null and b/src/user-manual/initial-setup/assets/setup.jpg differ
diff --git a/src/user-manual/initial-setup/assets/start-fresh.jpg b/src/user-manual/initial-setup/assets/start-fresh.jpg
new file mode 100644
index 0000000..b8cd70c
Binary files /dev/null and b/src/user-manual/initial-setup/assets/start-fresh.jpg differ
diff --git a/src/user-manual/initial-setup/restore-from-backup.md b/src/user-manual/initial-setup/restore-from-backup.md
new file mode 100644
index 0000000..8071489
--- /dev/null
+++ b/src/user-manual/initial-setup/restore-from-backup.md
@@ -0,0 +1,41 @@
+# Restoring from Backup
+
+```admonish danger
+Restoring from backup is for _disaster recovery_ only, meaning your StartOS data drive is lost or corrupted. If you have your existing data drive, please consider [using](./use-existing.md) or [transferring](./transfer.md) your data instead.
+```
+
+1. Click "Recover".
+
+ 
+
+1. Select "Restore From Backup".
+
+ 
+
+1. Select your backup drive.
+
+ 
+
+1. Decrypt the backup drive by entering the password that was used to create it.
+
+ 
+
+1. Select the _new_ drive that will receive your StartOS data.
+
+ ```admonish warning
+ Any data on this new drive will be _permanently erased_!
+ ```
+
+ 
+
+1. Create a password.
+
+ 
+
+1. StartOS will transfer your data to the new drive.
+
+ 
+
+1. On completion, download StartOS-info.html and continue to trusting your server's Root CA.
+
+ 
diff --git a/src/user-manual/initial-setup/start-fresh.md b/src/user-manual/initial-setup/start-fresh.md
new file mode 100644
index 0000000..a251b57
--- /dev/null
+++ b/src/user-manual/initial-setup/start-fresh.md
@@ -0,0 +1,27 @@
+# Starting Fresh
+
+1. Click "Start Fresh".
+
+ 
+
+1. Select your data drive.
+
+ ```admonish warning
+ Any data on this drive will be _permanently erased_!
+ ```
+
+ 
+
+1. Create a password.
+
+ 
+
+1. Your server will initialize.
+
+ 
+
+1. Download StartOS-info.html.
+
+ 
+
+1. Continue to [trusting your server's Root CA](../trust-ca.md).
diff --git a/src/user-manual/initial-setup/transfer.md b/src/user-manual/initial-setup/transfer.md
new file mode 100644
index 0000000..6c1ac70
--- /dev/null
+++ b/src/user-manual/initial-setup/transfer.md
@@ -0,0 +1,35 @@
+# Transferring Drives
+
+Select this option for upgrading to a faster or larger data drive.
+
+1. Click "Recover".
+
+ 
+
+1. Click "Transfer".
+
+ 
+
+1. Select the _old_ drive containing your StartOS data.
+
+ 
+
+1. Select the _new_ drive that will receive your StartOS data.
+
+ ```admonish warning
+ Any data on this new drive will be _permanently erased_!
+ ```
+
+ 
+
+1. Create a password.
+
+ 
+
+1. StartOS will transfer your data to the new drive.
+
+ 
+
+1. On completion, download StartOS-info.html and continue to trusting your server's Root CA.
+
+ 
diff --git a/src/user-manual/initial-setup/use-existing.md b/src/user-manual/initial-setup/use-existing.md
new file mode 100644
index 0000000..2af2318
--- /dev/null
+++ b/src/user-manual/initial-setup/use-existing.md
@@ -0,0 +1,27 @@
+# Using an Existing Drive
+
+Select this option if you (1) have re-flashed StartOS and want to resume normal operation on the same device or (2) are transplanting your existing data drive to a new device
+
+1. Click "Recover".
+
+ 
+
+1. Click "Use Existing Drive".
+
+ 
+
+1. Select your server's data drive.
+
+ 
+
+1. Create a password.
+
+ 
+
+1. Your server will initialize again (all previous data will be recovered).
+
+ 
+
+1. On completion, download StartOS-info.html and continue to trusting your server's Root CA.
+
+ 
diff --git a/src/user-manual/installing-services.md b/src/user-manual/installing-services.md
new file mode 100644
index 0000000..2217585
--- /dev/null
+++ b/src/user-manual/installing-services.md
@@ -0,0 +1,32 @@
+# Installing Services
+
+**Contents**
+
+1. [Installing from the Marketplace](#installing-from-the-marketplace)
+1. [Side Loading](#side-loading)
+
+## Installing from the Marketplace
+
+The Marketplace is made up of multiple "registries". A registry is a curated list of services that can be downloaded and installed onto StartOS. You can think of a registry as just one "store" or "booth" inside a broader marketplace.
+
+StartOS comes preloaded with two default registries: (1) The Start9 Registry and (2) the Community Registry.
+
+Services in the Start9 Registry are vouched for, recommended, supported, and maintained by Start9. Services in the Community Registry are not. For a more detailed explanation of the Registry framework, check out this short blog post.
+
+To install a service from the marketplace, simply visit the Marketplace, select a service, and click "Install".
+
+### Switching Registries
+
+To switch between registries or add a custom registry, simply click "Change" underneath the current Registry title.
+
+
+
+## Side Loading
+
+Side loading is useful if you are testing a service that does not yet exist on a registry, or if you prefer to eliminate the Marketplace as a point of trust. An s9pk can be obtained from anywhere or even built from source code.
+
+To side load a service, go to `System > Sideload a Service` and upload the appropriate .s9pk file.
+
+
+
+
diff --git a/src/user-manual/ssh.md b/src/user-manual/ssh.md
new file mode 100644
index 0000000..89d8304
--- /dev/null
+++ b/src/user-manual/ssh.md
@@ -0,0 +1,172 @@
+# Using SSH
+
+Like other Linux distributions, you can go "under-the-hood" via Secure Shell Protocol (SSH) if you choose. Even though StartOS is designed to be used from the GUI, it is a good idea to set up SSH access. It can be useful for debugging purposes as well as advanced functionality.
+
+```admonish warning
+For security reasons, StartOS _disables_ access is not available, so you will need to add an SSH key to your server via the method below.
+```
+
+**Contents**
+
+1. [Creating an SSH Key](#creating-an-ssh-key)
+1. [Registering Your SSH Key with StartOS](#registering-your-ssh-key-with-startos)
+1. [SSH over LAN](#ssh-over-lan)
+1. [Connecting via PuTTY on Windows](#connecting-via-putty-on-windows)
+1. [SSH over Tor](#ssh-over-tor)
+
+## Creating an SSH Key
+
+1. Open a terminal on your client device and enter the following command.
+
+ ssh-keygen -t ed25519
+
+ You will be asked to enter a file in which to save the key. We recommend pressing Enter to use the default location
+
+1. Optionally create a passphrase, or press enter for no passphrase.
+
+ The next 3 step are for **Linux and Mac users only**. Windows users skip to [Registering Your SSH Key with StartOS](#registering-your-ssh-key-with-startos)
+
+1. The terminal will inform you that your public key has been saved. Take note of the path.
+
+ Your public key has been saved in /home/user/.ssh/id_ed25519.pub
+
+1. Start your system's `ssh-agent`:
+
+ eval "$(ssh-agent -s)"
+
+1. Add your key to the ssh-agent:
+
+ ssh-add ~/.ssh/id_ed25519
+
+ Note: if you changed the file name/location in step 1, you will need to use that file/path in this step
+
+## Registering Your SSH Key with StartOS
+
+1. Open a terminal on your client device and display your SSH _public_ key (created above):
+
+ - Mac and Linux:
+
+ cat ~/.ssh/id_ed25519.pub
+
+ - Windows:
+
+ type .ssh\id_ed25519.pub
+
+1. Copy the resulting line that looks similar to
+
+ ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAINH3tqX71XsPlzYhhoo9CqAP2Yx7gsGTh43bQXr1zqoq user@email.com
+
+1. In StartOS, navigate to `System > SSH`.
+
+1. Click "Add New Key".
+
+1. Paste your SSH public key (copied above).
+
+1. Click "Submit".
+
+## SSH over LAN
+
+1. Open a terminal on your client device and enter:
+
+ ssh start9@SERVER-HOSTNAME
+
+ Replace `SERVER-HOSTNAME` with your server's `adjective-noun.local` address URL.
+
+1. The first time you connect, you will see something like this:
+
+ The authenticity of host 'adjective-noun.local (192.168.1.175)' can't be established.
+
+ ED25519 key fingerprint is SHA256:BgYhzyIDbshm3annI1cfySd8C4/lh6Gfk2Oi3FdIVAa.
+
+ This key is not known by any other names.
+
+ Are you sure you want to continue connecting (yes/no/[fingerprint])?
+
+ Type "yes" and hit Enter to start trusting the server's SSH public key.
+
+ ```admonish note
+
+ If you get a scary looking warning that says something like
+
+ WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!
+
+ Fear not! This is most likely happening because you have recently re-flashed your server, which causes a change in the key for your device's hostname. The solution is to delete the existing entry from your `known_hosts` file, which is typically located at `~/.ssh/known_hosts`. This will be specified in the warning, along with a helpful line number (in case your file is lengthy).
+ ```
+
+## Connecting via PuTTY on Windows
+
+For Windows, following the command above will work. But if you prefer a GUI tool, BrewsBitcoin has created a guide for connecting via SSH using PuTTY on Windows
+
+## SSH over Tor
+
+```admonish warning
+
+Terminal SSH over Tor is only supported on Linux and MacOS. For Windows, it is only possible with PuTTY as seen here. Note: those instructions use port 9150, but we've configured Tor in Windows on the traditional port 9050.
+
+```
+
+1. Install `torsocks`
+
+ - Mac:
+
+ brew install torsocks
+
+ - Debian / Ubuntu
+
+ sudo apt install torsocks
+
+ - Arch / Garuda / Manjaro
+
+ sudo pacman -S torsocks
+
+1. Run the following command:
+
+ echo -e "\nHost *.onion\n\tProxyCommand nc -xlocalhost:9050 %h %p" >> ~/.ssh/config
+
+ This command adds a wildcard setting for .onion domains to your SSH config file. Any .onion domains you connect to using SSH will use the specified proxy command.
+
+1. SSH into StartOS:
+
+ ```admonish warning
+
+ The changes you make here are on the overlay and won't persist after a restart of your server.
+ ```
+
+ ssh start9@.local
+
+1. Elevate yourself to root in chroot edit mode (which will make your changes persist across reboots):
+
+ sudo /usr/lib/startos/scripts/chroot-and-upgrade
+
+1. Using Vim or Nano, add the following 2 lines to `/etc/tor/torrc`
+
+ HiddenServiceDir /var/lib/tor/ssh
+ HiddenServicePort 22 127.0.0.1:22
+
+ ```admonish tip
+
+ You can also add these lines by running the following command:
+
+ echo -e "\nHiddenServiceDir /var/lib/tor/ssh\nHiddenServicePort 22 127.0.0.1:22" >> /etc/tor/torrc
+ ```
+
+1. Restart your Start9 server by exiting chroot edit mode:
+
+ exit
+
+1. SSH in again to gather you newly-generated SSH ".onion" address:
+
+ sudo cat /var/lib/tor/ssh/hostname
+
+ ```admonish note
+
+ This .onion address is only for SSH access and should not be confused with your server's main .onion address.
+ ```
+
+1. Exit SSH
+
+ exit
+
+1. Now you can SSH into your server using your SSH ".onion" URL:
+
+ ssh start9@xxxxxxxxxxxxxxxxx.onion
diff --git a/src/user-manual/trust-ca.md b/src/user-manual/trust-ca.md
new file mode 100644
index 0000000..d0f955d
--- /dev/null
+++ b/src/user-manual/trust-ca.md
@@ -0,0 +1,44 @@
+# Trusting Your Root CA
+
+To establish a secure (HTTPS) connection with your server, it is necessary to download and trust your server's Root Certificate Authority (Root CA).
+
+**Contents**
+
+1. [Download Your Root CA](#download-your-root-ca)
+1. [Trust Your Root CA](#trust)
+
+## Download your Root CA
+
+There are multiple ways to download your Root CA.
+
+1. From the HTTP login screen.
+
+ Visit your server's `http://.local` URL.
+
+ 
+
+1. From your StartOS-info.html file.
+
+ Following initial setup, you were required to download a StartOS-info.html file. Your Root CA can be downloaded from this file.
+
+ 
+
+1. Over Tor.
+
+ You can securely access your server using its `http://....oinion` URL from any Tor-enabled browser. From there, you can download your Root CA by going to `System -> Root CA`.
+
+ 
+
+1. Sending to yourself.
+
+ Once you have downloaded your Root CA on one device, you can simply send the file to yourself using email, messaging app, or other file sharing technique.
+
+## Trust your Root CA
+
+Select your client device OS and follow instructions
+
+- [Linux](../../guides/device-guides/linux/linux-ca.md)
+- [Mac](../../guides/device-guides/mac/mac-ca.md)
+- [Windows](../../guides/device-guides/windows/windows-ca.md)
+- [Android](../../guides/device-guides/android/android-ca.md)
+- [iOS](../../guides/device-guides/ios/ios-ca.md)
diff --git a/src/user-manual/updating-startos.md b/src/user-manual/updating-startos.md
new file mode 100644
index 0000000..887f521
--- /dev/null
+++ b/src/user-manual/updating-startos.md
@@ -0,0 +1,37 @@
+# Updating StartOS
+
+```admonish info
+
+StartOS does not have automatic updates and will _never_ update without your approval. That said, we highly recommended keeping StartOS up to date for the latest security and performance patches, as well as to take advantage of new features.
+```
+
+**Contents**
+
+1. [Updating through the UI](#updating-through-the-ui)
+1. [Update by Re-flashing](#update-by-re-flashing)
+
+## Update through the UI
+
+1. When a new version of StartOS is available, a rocket badge will appear on the "System" tab.
+
+1. Go to `System > Software Update`.
+
+1. Read the release notes and click "Begin Update".
+
+ ```admonish danger
+
+ Ensure you have a stable Internet connection before beginning an OS update, and do not unplug your server while StartOS is downloading.
+ ```
+
+1. While the new version of StartOS is downloading, you may continue to use your device as usual.
+
+1. Once the download is complete, you will be prompted to restart your server to complete the update.
+
+ ```admonish danger
+
+ Updates can take up to an _hour_ to complete. During this time, there is no indication of progress and your StartOS UI will be unreachable. **DO NOT UNPLUG YOUR SERVER DURING THIS TIME!**
+ ```
+
+## Update by Re-flashing
+
+If you updating to an unreleased version of StartOS, or something went wrong with a UI update (very rare), it may be necessary to update StartOS by re-flashing. Follow the guide for [Flashing StartOS]().
diff --git a/src/user-manual/wifi.md b/src/user-manual/wifi.md
new file mode 100644
index 0000000..27d2b7f
--- /dev/null
+++ b/src/user-manual/wifi.md
@@ -0,0 +1,15 @@
+# Using WiFi
+
+StartOS does not have WiFi capabilities.
+
+Servers are intended to be online 24/7, and a direct, Ethernet connection is always faster and more reliable than WiFi.
+
+However, WiFi can sometimes be necessary, such as in a school or office setting where Ethernet connections are not available. In these circumstances, we recommend using a WiFi extender.
+
+You connect the WiFi extender to the available WiFi network, then you connect your StartOS server to the WiFi extender using Ethernet. It is that easy.
+
+The WiFi extenders below have been tested to work with StartOS, but other extenders should also work.
+
+- https://www.amazon.com/TP-Link-AC750-WiFi-Range-Extender/dp/B07N1WW638
+
+- https://www.amazon.com/Wifi-Extender-Booster-Wireless-Repeater
diff --git a/src/walkthrough/README.md b/src/walkthrough/README.md
deleted file mode 100644
index 53e0016..0000000
--- a/src/walkthrough/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# StartOS Walkthrough
diff --git a/src/walkthrough/customize.md b/src/walkthrough/customize.md
deleted file mode 100644
index 90570e9..0000000
--- a/src/walkthrough/customize.md
+++ /dev/null
@@ -1 +0,0 @@
-# Customization
diff --git a/src/walkthrough/mainUI.md b/src/walkthrough/mainUI.md
deleted file mode 100644
index 1afb9d5..0000000
--- a/src/walkthrough/mainUI.md
+++ /dev/null
@@ -1 +0,0 @@
-# Main UI
diff --git a/src/walkthrough/marketplace/README.md b/src/walkthrough/marketplace/README.md
deleted file mode 100644
index 54d93e4..0000000
--- a/src/walkthrough/marketplace/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# Marketplace
diff --git a/src/walkthrough/marketplace/registries.md b/src/walkthrough/marketplace/registries.md
deleted file mode 100644
index 04d2ff5..0000000
--- a/src/walkthrough/marketplace/registries.md
+++ /dev/null
@@ -1 +0,0 @@
-# Managing registries
diff --git a/src/walkthrough/services.md b/src/walkthrough/services.md
deleted file mode 100644
index 3142ea6..0000000
--- a/src/walkthrough/services.md
+++ /dev/null
@@ -1 +0,0 @@
-# Managing Services
diff --git a/src/walkthrough/sessions.md b/src/walkthrough/sessions.md
deleted file mode 100644
index f3ab475..0000000
--- a/src/walkthrough/sessions.md
+++ /dev/null
@@ -1 +0,0 @@
-# Session Management
diff --git a/src/walkthrough/ssh.md b/src/walkthrough/ssh.md
deleted file mode 100644
index 7b0b17f..0000000
--- a/src/walkthrough/ssh.md
+++ /dev/null
@@ -1 +0,0 @@
-# SSH
diff --git a/src/walkthrough/wifi-bt.md b/src/walkthrough/wifi-bt.md
deleted file mode 100644
index 3f38fa2..0000000
--- a/src/walkthrough/wifi-bt.md
+++ /dev/null
@@ -1 +0,0 @@
-# WiFi & Bluetooth
diff --git a/theme/favicon.png b/theme/favicon.png
index f0aafd1..fdee49b 100644
Binary files a/theme/favicon.png and b/theme/favicon.png differ
diff --git a/theme/favicon.svg b/theme/favicon.svg
new file mode 100644
index 0000000..594ac43
--- /dev/null
+++ b/theme/favicon.svg
@@ -0,0 +1,5 @@
+