Files
raven/docs/8.0/ayanova/docs/ops-config-use-urls.md
John Cardinal c6c9e6c5d3 case 4727 - docs: Linux server permissions, service security settings, 127.0.0.1 behind NGINX
Install: program files read only for the service account, config.json 640,
systemd security settings in the service file, and a final step binding
AyaNova to 127.0.0.1 once NGINX works. Upgrade: the pre-8.3.0 step sets the
same permissions instead of re-adding group write on the program folder,
offers the security settings as a drop-in, and the upgrade commands use
curl -fO so a failed download stops before the program files are deleted.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-26 14:14:05 -07:00

1.4 KiB

Port / URL setting

You can control the port and URL that the AyaNova server will listen on via environment variable or command line parameter.

Default

If no override is specified AyaNova will use the following default value:

"http://*:7575"

This means AyaNova will listen on port 7575 on all of the computer's network addresses.

Behind a reverse proxy

When all users connect through a reverse proxy (such as NGINX) on the same computer, use 127.0.0.1 in place of *, for example "http://127.0.0.1:7575". AyaNova then accepts connections only from that computer, so it can not be reached directly over unencrypted HTTP, bypassing the reverse proxy. See the Linux server installation instructions.

Overriding

AyaNova expects the PORT and URL to be provided by a config.json property, environment variable or command line parameter named

AYANOVA_USE_URLS

The value specified should be a string of one or more semicolon separated values, for example: http://*:5000;http://localhost:5001;https://hostname:5002

Example config.json entry

{
  ...other properties...
  "AYANOVA_USE_URLS": "http://*:49152"
}

Example command line parameter

ayanova.exe --AYANOVA_USE_URLS="http://*:5000"

Example environment variable

Windows

set "AYANOVA_USE_URLS=http://*:5000"

Linux

export AYANOVA_USE_URLS="http://*:5000"