From 4130a59d967c85534a3b32fbe66f410f9c863b3f Mon Sep 17 00:00:00 2001
From: John Cardinal <support@ayanova.com>
Date: Wed, 8 Dec 2021 21:26:37 +0000
Subject: [PATCH]

---
 .../ayanova/docs/ops-install-linux-desktop.md | 65 +++++++++++++++++++
 1 file changed, 65 insertions(+)
 create mode 100644 docs/8.0/ayanova/docs/ops-install-linux-desktop.md

diff --git a/docs/8.0/ayanova/docs/ops-install-linux-desktop.md b/docs/8.0/ayanova/docs/ops-install-linux-desktop.md
new file mode 100644
index 00000000..77c735e7
--- /dev/null
+++ b/docs/8.0/ayanova/docs/ops-install-linux-desktop.md
@@ -0,0 +1,65 @@
+# AYANOVA INSTALLATION - LINUX DESKTOP USER GUIDE
+
+The "desktop" installation is appropriate for a single user of AyaNova on a Linux x64 Desktop OS computer accessed with local browser.
+
+## Ubuntu
+
+These instructions were compiled and tested on an Ubuntu 21.10 Desktop OS however any Linux x64 variant should work provided the ASP.NET Core framework can be installed to it.
+
+## System requirements
+
+- OS : Linux x64 desktop operating system [supported by ASP.NET Core](https://docs.microsoft.com/en-us/dotnet/core/install/linux)
+- Internet connection : required to install license and to automatically download the Chromium report rendering engine
+- Disk space: minimum 400mb of free disk space
+- RAM : 512 MB (minimum), 1 GB (recommended)
+- Modern web browser with Javascript enabled
+
+## Installation procedure
+
+### ASP.NET Core runtime
+
+AyaNova requires the ASP.NET Core runtime version 6.0 or newer.
+Install the ASP.NET CORE runtime using this guide for your specific OS [https://docs.microsoft.com/en-us/dotnet/core/install/linux](https://docs.microsoft.com/en-us/dotnet/core/install/linux)
+
+
+### PostgreSQL server
+
+AyaNova requires access to a PostgreSQL database server version 12 or newer. If you do not have a PostgreSQL server already available then it must be installed to a location visible to the AyaNova server (same computer or a local computer on the same network). 
+
+We recommend *not* using the version of PostgreSQL provided by your OS package manager as they tend to be out of date.
+
+To install PostgreSQL directly start here [https://www.postgresql.org/download/linux/](https://www.postgresql.org/download/linux/)
+
+### Set the PostgreSQL password
+If you are installing a local copy of PostgreSQL for the first time to use with AyaNova a password will need to be set for access.  If you have an existing PostgreSQL server then you can skip this step but will need the Postgre server password in a later step.
+
+Open the terminal (ctrl-alt-t):
+Type `sudo -u postgres psql`
+This should open a postgres psql command window
+Type `ALTER USER postgres PASSWORD 'YOUR_PASSWORD_HERE';` substituting your desired password here and be sure to make a note of it for later.
+If successful psql will display "ALTER ROLE" in response and you can close the psql terminal by typing `\q` to quit.
+
+
+### AyaNova server installation
+
+Once you have ensured the two requirements above are installed and available; download the AyaNova server archive: [https://www.ayanova.com/Downloads/v8/ayanova-linux-x64-desktop.zip](https://www.ayanova.com/Downloads/v8/ayanova-linux-x64-desktop.zip). 
+
+
+
+
+
+
+
+
+
+////////////////////////////////////////////////////
+- Download and run the standalone installer from our web site: [https://www.ayanova.com/Downloads/v8/ayanova-windows-x64-single-setup.exe](https://www.ayanova.com/Downloads/v8/ayanova-windows-x64-single-setup.exe). Follow the prompts and accept the defaults. At the end of setup the ayanova-launcher application will start if selected (or you can run it from the desktop icon) and in turn it will start the Postgres server, AyaNova server and then open the default web browser to both the AyaNova server interface and the AyaNova User interface.
+
+## Starting and stopping AyaNova server
+
+To shut down the AyaNova server press the ctrl-c key combination in the ayanova-launcher window.
+To start the AyaNova server use the installed desktop or start menu icon to run the ayanova-launcher.
+
+## Getting started and using AyaNova
+
+The next step is to follow the [getting started](adm-getting-started.md) guide for using and administrating AyaNova from a business point of view and also the [operations maintenance](ops-maintenance.md) guide to ensure AyaNova runs smoothly and data is safe and secure.