docs: add dashboard setup (#309)

2 files changed, 262 insertions, 9 deletions

diff --git a/docs/Install-with-AC-Dashboard.md b/docs/Install-with-AC-Dashboard.md
new file mode 100644
index 0000000..76fc6c9
--- /dev/null
+++ b/docs/Install-with-AC-Dashboard.md
@@ -0,0 +1,240 @@
+## Introduction
+
+The AzerothCore bash dashboard is a collection of scripts that help with the installation and maintenance of an AzerothCore server.
+It allows to easily install, update and execute AzerothCore on your machine in a tremendously small amount of steps.
+
+Installing a development or production private server has never been so easy before. 
+If you need any help just [ask a question](https://www.azerothcore.org/wiki/How-to-ask-for-help).
+
+
+## Requirements
+
+You need to have [git](https://git-scm.com/) installed in your machine. 
+No other software is required to be installed manually.
+
+- debian/ubuntu-based: `apt update && apt install git`
+- macOS: `brew install git`
+
+### Notes
+- For macOS users: install and use the latest version of bash to run the commands of the dashboard (`brew install bash`)
+- For Windows users: the commands need to be executed within the "git bash" shell or a bash-compatible shell such as WSL, cygwin etc..
+  However, git bash is suggested because is preinstalled with git for windows (one of our requirements)
+  
+
+## Setup
+
+### Get the AC sources
+
+```
+git clone https://github.com/azerothcore/azerothcore-wotlk.git; cd azerothcore-wotlk`
+```
+
+### Configuration
+
+There is a [conf/dist/config.sh](https://github.com/azerothcore/azerothcore-wotlk/blob/master/conf/dist/config.sh) 
+file containing a default configuration. Have a look at it. 
+Most of the configuration defaults will probably work for your case, 
+but you can copy it under `conf/config.sh` and change values as you please.
+
+
+### Install all AC dependencies
+
+```
+./acore.sh install-deps
+```
+
+### Build everything from scratch
+
+```
+./acore.sh compiler all
+```
+
+### Set-up the database
+
+- Either connect to your MySQL database and manually create the `acore` MySQL user:
+
+```
+DROP USER IF EXISTS 'acore'@'localhost';
+DROP USER IF EXISTS 'acore'@'127.0.0.1';
+CREATE USER 'acore'@'localhost' IDENTIFIED BY 'acore';
+CREATE USER 'acore'@'127.0.0.1' IDENTIFIED BY 'acore';
+GRANT ALL PRIVILEGES ON * . * TO 'acore'@'localhost' WITH GRANT OPTION;
+GRANT ALL PRIVILEGES ON * . * TO 'acore'@'127.0.0.1' WITH GRANT OPTION;
+FLUSH PRIVILEGES;
+exit;
+```
+
+*Note:  even though the `acore` user is only accessible from localhost, 
+it is a good practice to change its password to something more secure.*
+
+- Or change the `config.sh` to use another MySQL user.
+
+Then run:
+
+```
+./acore.sh db-assembler import-all
+```
+
+this will install a full AzerothCore Database. No need to import any DB update at this point.
+
+### Download the latest client data
+
+Get the latest client data:
+
+```
+./acore.sh client-data
+```
+
+### Server config files
+
+```
+cp env/dist/etc/authserver.conf.dist env/dist/etc/authserver.conf
+```
+```
+cp env/dist/etc/worldserver.conf.dist env/dist/etc/worldserver.conf
+```
+
+### Result
+
+If you followed the above, you'll get your server inside the `env/dist` directory.
+
+The `worldserver` and `authserver` binaries are located in `azerothcore-wotlk/env/dist/bin`.
+
+You can either run them directly or use the restarter (see below).
+
+### Restarter
+
+The AzerothCore dashboard comes with a bundled restarter suite:
+
+```
+./acore.sh run-worldserver
+```
+
+```
+./acore.sh run-authserver
+```
+
+For dedicated servers, 
+you may want to run them inside terminal multiplexer sessions using tools like `tmux` (see below).
+
+
+## How to update your server
+
+Update the sources:
+
+```
+git pull
+```
+
+Rebuild:
+```
+./acore.sh compiler build
+```
+
+Update the database:
+
+```
+./acore.sh db-assembler import-updates
+```
+
+That's it.
+
+
+## Tips for dedicated (production) servers
+
+### Daily backups of your databases via Telegram
+
+Getting daily backups of your private server databases directly to your phone/computer 
+via [Telegram](https://telegram.org/) messages?
+
+Yes, that's possible. Just use: [azerothcore/telegram-automated-db-backup](https://github.com/azerothcore/telegram-automated-db-backup)
+
+### Visual Studio Code SSH
+
+You can easily install AzerothCore in a linux server without any kind of GUI,
+simply connecting remotely via ssh using [Visual Studio Code](https://code.visualstudio.com/)
+and the [SSH](https://code.visualstudio.com/docs/remote/ssh)
+and the [SSH: Editing Configuration Files](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh-edit) extensions so you'll feel just like at home.
+
+### Run AzerothCore inside Tmux sessions
+
+You can use [tmux](https://github.com/tmux/tmux) as terminal multiplexer, 
+it will allow you to easily manage your processes inside a server with no GUI.
+
+You can create 2 sessions and run the `worldserver` and `authserver` processes inside them:
+
+- `tmux new -s world-session`
+- now run the `./acore.sh run-worldserver` inside it, then detach from it
+
+
+- `tmux new -s auth-session`
+- now run the `./acore.sh run-worldserver` inside it, then detach from it
+
+You can detach using `CTRL+B+D` to exit the session without killing the process.
+If connected using VSCode SSH, you can just close the terminal session.
+
+You can attach again to the `world-session` session using:
+
+- `tmux attach -t world-session`
+
+Other useful commands:
+
+- create a new session: `tmux new -s my_session`
+- list all sessions: `tmux ls`
+- kill a session: `tmux kill my_session` (or just attach to it and type `exit`)
+- ...more details available at the [tmux wiki](https://github.com/tmux/tmux/wiki)
+
+
+### Automatically start the tmux sessions at system startup
+
+You can automatically create the tmux sessions and execute the `authserver` and `worldserver` using this simple script:
+
+```sh
+#!/usr/bin/env bash
+
+# CHANGE THESE WITH THE CORRECT PATHS
+authserver="/path/to/azerothcore-wotlk/env/dist/bin/authserver"
+worldserver="/path/to/azerothcore-wotlk/env/dist/bin/worldserver"
+
+authserver_session="auth-session"
+worldserver_session="world-session"
+
+if tmux new-session -d -s $authserver_session; then
+    echo "Created authserver session: $authserver_session"
+else
+    echo "Error when trying to create authserver session: $authserver_session"
+fi
+
+if tmux new-session -d -s $worldserver_session; then
+    echo "Created worldserver session: $worldserver_session"
+else
+    echo "Error when trying to create worldserver session: $worldserver_session"
+fi
+
+if tmux send-keys -t $authserver_session $authserver C-m; then
+    echo "Executed \"$authserver\" inside $authserver_session"
+    echo "You can attach to $authserver_session and check the result using \"tmux attach -t $authserver_session\""
+else
+    echo "Error when executing \"$authserver\" inside $authserver_session"
+fi
+
+if tmux send-keys -t $worldserver_session $worldserver C-m; then
+    echo "Executed \"$worldserver\" inside $worldserver_session"
+    echo "You can attach to $worldserver_session and check the result using \"tmux attach -t $worldserver_session\""
+else
+    echo "Error when executing \"$worldserver\" inside $worldserver_session"
+fi
+```
+
+On unix systems, you can then use [crontab](https://en.wikipedia.org/wiki/Cron) 
+to run the script automatically at system startup:
+
+```
+crontab -e
+```
+
+then add this line (replace `/path/to/startup.sh` with the path of where you placed the above script):
+
+```
+@reboot /bin/bash /path/to/startup.sh
+```
diff --git a/docs/Installation.md b/docs/Installation.md
index ef05290..9ea0fd9 100644
--- a/docs/Installation.md
+++ b/docs/Installation.md
@@ -1,20 +1,33 @@
-# AZEROTHCORE INSTALLATION
+# AzerothCore Installation
 
-## DOCKER INSTALLATION
+There are several ways to install AzerothCore, you need to pick **one**.
 
-This page describes how to use [AzerothCore with Docker](Install-with-Docker.md).
+- **Azerothcore Classic setup** - the traditional way of installing AzerothCore.
+  Battle-tested, recommended for all operating systems for any purposes.
+  This process gives more awareness of how AzerothCore is structured. **See below in this page**.
+  
 
-## AWS INSTALLATION
+- **AzerothCore Docker setup** - a simplified installation process based on Docker. 
+  See [**Install AzerothCore with Docker**](Install-with-Docker.md).
 
-This page describes how to use [AzerothCore with AWS](aws-tutorial.md)
 
-## DIGITALOCEAN CLOUD
+- **[NEW] AzerothCore Bash Dashboard setup** - simplest way of installing AzerothCore, 
+  recommended for **Linux** systems for both local development and production. 
+  Currently not recommended for Windows or macOS.
+  See [**Install AzerothCore using the AC bash dashboard**](Install-with-AC-Dashboard.md).
+  **Disclaimer**: These scripts are supposed to be cross-platform, however we are not quite there yet.
+  It's not currently recommended to use the installation process described in this page on Windows or macOS.
+  You can of course try them anyway and [let us know](https://github.com/azerothcore/azerothcore-wotlk/issues/new/choose) in case you encounter any issue.
+  That does not mean that you cannot use this in production.
+  We tested this procedure on a dedicated server machine running Ubuntu 20.04 and it worked quite nicely,
+  we'll include here some extra tips for production environments as well.
 
-This page describes how to use [AzerothCore on a Digital Ocean droplet](digital-ocean-video-tutorial.md)
 
-## ArchLinux and Arch based distro
+Other tutorials from the community for specific platforms:
 
-This page describes how to use [AzerothCore with ArchLinux](arch-linux.md)
+- [Install AzerothCore on Amazon Web Services](aws-tutorial.md)
+- [Install AzerothCore on a Digital Ocean droplet](digital-ocean-video-tutorial.md)
+- [Install AzerothCore with ArchLinux](arch-linux.md)
 
 ## CLASSIC INSTALLATION