5.3 KiB
AYANOVA LINUX INSTALLATION
Choose how AyaNova will be used for specific Linux installation instructions. Note that it's possible to switch to an alternative configuration via backup and restore if needs change later however if there is a possibility that AyaNova will be accessed from the internet it's recommended to install using the NGINX proxy server instructions below.
Single user desktop installation
This type of install is appropriate for using AyaNova locally on a single personal computer only. This type of installation is not appropriate for sharing with multiple users.
Single user desktop isntall guide
Shared multiple user server installation
When more than one user will be accessing AyaNova it can be set up in two different ways on a Linux server either on-premise or with any Linux hosting provider such as DigitalOcean or Linode that provides full shell access to a virtual or physical server.
Local area network
AyaNova server running alone and access directly by users within a local office network.
This type of install is appropriate for use within a local area network only. It is not suitable for sharing with outside users from the Internet.
Pros:
- Does not require NGINX or an SSL certificate for in-office use / simpler to install
Cons:
- Not suitable for sharing with users / Customers outside the local area network via the internet
Local area network install guide
AyaNova server with NGINX proxy server
AyaNova behind an NGINX proxy server.
This type of install is appropriate for users who access AyaNova from the Internet in addition to local users accessing via a local area network.
Pros:
- Secured behind NGINX for remote users and optionally Customers on the Internet
- Uses an SSL certificate with NGINX which ensures all communications are encrypted between remote users and the AyaNova server
Cons:
- Requires NGINX and some manual steps to configure NGINX to work with AyaNova
- Requires PostgreSQL to be installed or available
NGINX proxied AyaNova server install guide
//############################################################################################################################## GET WORKING MANUALLY THEN CAN DO DOCS ONCE HAVE PROCESS HERE (expand the instructions on stack overflow pages and link to the pg and asp.net core install pages) SPLIT THIS OUT INTO MULTIPLE PAGES LIKE WINDOWS
//#################################### LINUX DESKTOP ################################
Linux DESKTOP standalone ubuntu desktop todo: put running on desktop image at top here SYSTEM REQUIREMENTS NOTE: painfully slow with 1gb, probably needs 2gb to work properly
- Install ASP.NET CORE runtime using this guide: https://docs.microsoft.com/en-us/dotnet/core/install/linux
IF no postgreSQL already:
- Install postgreSQL https://www.postgresql.org/download/linux/ubuntu/
Note: the version that comes with even the newest ubuntu is 2 versions out of date so best to follow the install guide to directly install from pg
as it will auto-update and be the most recent secure version
- Set postgres password
https://stackoverflow.com/a/14588440
test@test-VirtualBox:~$ sudo -u postgres psql
psql (14.1 (Ubuntu 14.1-1.pgdg21.10+1))
Type "help" for help.
postgres=# ALTER USER postgres PASSWORD 'letmein';
ALTER ROLE
postgres-# \q
- Make AyaNova AYANOVA_DATA_PATH folder in your home folder, default expected is: ~/.ayanova-data
sudo mkdir ~/.ayanova-data
Note: You don't have to use this path but if you change it then this will be required to be set in a config file in a later step
- download ayanova linux x64 archive
https://www.ayanova.com/Downloads/v8/ayanova-linux-x64-desktop.zip
- Make program folder:
sudo mkdir /usr/bin/ayanova
- copy archive to program folder
sudo cp ayanova-linux-x64-desktop.zip /usr/bin/ayanova/
- Unzip the archive into an appropriate folder (/usr/bin/ayanova)
sudo unzip ayanova-linux-x64-desktop.zip
- Set permissions on AyaNova:
sudo chmod 777 ./AyaNova
- edit config.json
sudo nano config.json
change "mypasswordforpostgres" in AYANOVA_DB_CONNECTION to the password set for postgres above
set AYANOVA_DATA_PATH location if not using the default which is: ~/.ayanova-data
start AyaNova:
sudo ./AyaNova
Verify it's working
- open browser and navigate to http://localhost:7575/login (or whatever port was enabled)
//############################################################# server lan ubuntu local network
//############################################################# nginx lan ubuntu internet
############################################################### //DOCKER https://www.ayanova.com/Downloads/v8/ayanova-linux-docker-x64-server.zip https://dotnetthoughts.net/how-to-nginx-reverse-proxy-with-docker-compose/ todo: this is not nearly enough, I need to make it fully working with NGINX containerized etc I think maybe this is best left as a howto document instead of a built config
todo: Docker config add path to chromium in env variable: lo.ExecutablePath = ServerBootConfig.AYANOVA_REPORT_RENDER_BROWSER_PATH;//"/usr/bin/chromium-browser";//this is the default path for docker based alpine dist