Configuration

Eonza program does not require installation and is distributed as a single executable file. At the first launch it creates all the necessary directories and files.

  • log - the directory for storing the log of the program and scripts.
  • users - directory for storing user settings.
  • eonza(.exe) - Eonza program.
  • eonza.eox - binary file with data. It contains user-created scripts and common settings.
  • eonza.yaml - configuration file.

Config File

The main settings of the program are stored in the YAML configuration file eonza.yaml. Below is an example of a configuration file, which is created by default.

 1version: 1.1.0+1
 2mode: default
 3assetsdir: ""
 4log:
 5  dir: ""
 6  mode: file
 7  level: info
 8users:
 9  dir: ""
10http:
11  host: localhost
12  port: 3234
13  open: true
14  theme: default
15  access: localhost
16  jwtkey: s5c82473epey
17playground:
18  dir: ""
19  summary: 0
20  files: 0
21  size: 0
22whitelist: []
  • version - Eonza version.
  • mode - program operation mode. If not specified, the program will run in the default mode. The following options are available:
    • default - default mode.
    • develop - developer mode.
    • playground - safe "sandbox" mode.
  • assetsdir - by default, the frontend files (html, js, png) are packed into an executable file. You can specify the directory with the unpacked files. This allows you to use modified versions of the files.
  • whitelist - if you installed Eonza on a remote server (hosting), we recommend specifying a "whitelist" of ip addresses in addition to password protection. In this case, specify the array of subnets from which which it is possible to connect to the program. If a request to Eonza comes from an ip-address that is not included in any of the specified networks, an error will be sent - Access denied. When defining the "whitelist", be sure to add the following subnetworks to it: ::1/128, 127.0.0.0/31.
1whitelist:
2  - ::1/128
3  - 127.0.0.0/31
4  - 192.168.0.0/24

Logging section

  • dir - path to the directory with log-files. If it is equal to an empty line, the log subdirectory in the directory with the configuration file is used.
  • mode - log type. It can be the combination of file and/or stdout. If it is not specified, then the logging is disabled. For example, mode: file stdout.
  • level - logging level. May be disable, error, warn, info.

Users section

  • dir - path to the directory with user data. If it is equal to an empty line, the users subdirectory in the directory with configuration file is used.

HTTP Configuration

Eonza launches a web server to display the program in a browser. Here are the settings related to the work of the web server.

  • host - hostname (domain) by which you can access Eonza if you run the program on a remote server. In this case access field should be host. You should also set a password and specify a whitelist of IP addresses to access.
  • port is the port that the web server uses. By default, 3234.
  • open - specify false if you do not want to automatically open the tab in your browser when you start the program.
  • theme - reserved.
  • access - can be one of the following values:
    • private - access only from LAN IP.
    • localhost - access by domain localhost.
    • host - indicates that Eonza is installed on a remote server. In this case, the host (domain) name must be specified in the host field.
  • jwtkey is the secret key for creating JWT authorization tokens. It is needed in case you login by password. The key is generated automatically when the configuration file is created, but you can change it later.

Playground Mode Settings

If you specified the playground program mode, you can define the following additional settings for that mode.

  • dir - path to the directory for writing and reading the files. If it is not specified, the subdirectory in the temporary directory will be created.
  • summary - the total size of the files. By default, it is 10 MB.
  • files - maximum number of files. By default, 100.
  • size - maximum file size. The default size is 5 MB.
  • tasks - maximum number of simultaneously running scripts. By default, 2.
1mode: playground
2...
3playground:
4    dir: "/tmp/eonza/playground"
5    summary: 20000000
6    files: 250
7    size: 3000000
8    tasks: 3
Online Demo
Downloads Documentation Scripts
English
Русский