This commit is contained in:
@@ -10,114 +10,7 @@ This type of install is appropriate for using AyaNova locally on a single person
|
||||
|
||||
## 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.
|
||||
When more than one user will be accessing AyaNova it can be set up on a Linux server either on-premise or with a Linux hosting provider such as DigitalOcean or Linode that provides full shell access to a virtual or physical server.
|
||||
|
||||
### Local area network
|
||||
[Server install guide](ops-install-linux.server.md)
|
||||
|
||||
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](ops-install-linux-lan.md)
|
||||
|
||||
### 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](ops-install-linux-nginx.md)
|
||||
|
||||
//##############################################################################################################################
|
||||
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 "YOUR_PASSWORD_HERE" 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
|
||||
|
||||
Reference in New Issue
Block a user