Skip to content

System Settings

System Settings allow administrators to configure global environment variables, application paths, and operational parameters for the entire platform. These settings define how the system handles file uploads, backups, automated alerts, and multi-tenancy configurations.

The System Settings interface, as shown in akas-admin-settings, provides a centralized list of configuration keys. Each setting is defined by a unique name, a current value, and a remark explaining its purpose.

akas-admin-settings

The following table provides detailed information for each system setting based on the current configuration:

Setting NameDescription & RemarkDefault / Sample Value
AI_CHAT_ENABLEDIf true, show the AI Assistant UI and allow assistant APIs. See AI Assistant.false
ALLOW_FILE_EXTList of permitted file extensions. Enter extensions without the dot and separated by commas.jpg, png, pdf, zip, …
ALLOW_MAX_FILE_SIZEThe maximum allowed file size for uploads, measured in Megabytes (MB).8
APP_PATHThe primary web application URL address.http://localhost:3001
ATT_DOWNLOAD_CLEARIf set to true, the system will clear attendance logs from the physical devices after a successful download.false
BACKUP_PATHThe directory path where backup files are stored. Defaults to ./backups.[blank]
BACKUP_PG_DUMP_PATHThe specific directory path to the pg_dump utility for database backups.[blank]
BACKUP_RETENTION_DAYSThe number of days the system will retain backup files before they are deleted.7
CORSAllowed browser origin suffixes for Cross-Origin requests (comma-separated). The request Origin must end with one of these values (e.g. localhost:8800, akas.co). Seeded once from appsettings Cors when missing; edit here to allow new sites without redeploying.localhost:3000, localhost:3001, localhost:8800, akas.co
CUSTOMIZE_CODEA unique customization code representing the company (e.g., used for customization identification).akas
EMP_EXPIRE_CHECKLIST_ALERT_DAYSThreshold in days to trigger alerts for expiring employee documents or checklists.30
EMP_EXPIRE_CONTRACT_ALERT_DAYSThreshold in days to trigger alerts for employee contracts that are about to expire.30
EMP_PROBATION_ALERT_DAYSThreshold in days to trigger alerts for employees approaching the end of their probation period.30
LEAVE_CALENDAR_TEAMONLYIf true, users can only see the leave information of members within their own team on the calendar.false
LEAVE_ESS_VALIDATE_DATESIf true, the Employee Self Service (ESS) will prevent users from re-requesting dates that were previously rejected.false
OUTGOING_EMAILFor testing only. If set, all system-generated emails will be sent to this specific recipient address. Default value: [blank][email protected]
PAYROLL_HALF_PERIODEnables the functionality to run payroll processing twice within a single period.true
PAYROLL_HALF_PERIOD_CUTOFF_DAYThe specific day of the month used as the cutoff between the first and second half of the payroll period.15
REPORT_IMG_DPIThe resolution (DPI) for image exports in some reports like invoice, receipt. Valid range: 96 to 1200.220
REPORT_IMG_QUALITYThe quality/compression level for image exports in reports. Valid range: 1 to 100.60
SMTP_SERVER / PORTThe mail server address and port used for outgoing system notifications.smtp.gmail.com / 587
SMTP_USER / PASSWORDThe credentials (username and application password) used to authenticate the SMTP server.[email protected]
SMTP_SENDERThe display name that appears as the “Sender” in system-generated emails.AKAS Cloud
SMTP_TIMEOUTThe number of seconds the system will wait before timing out a mail server connection.20
SURNAME_FIRSTIf true, the system will automatically format partner names with the surname appearing first.true
WIN_AUTH_DOMAINThe specific domain name used for authenticating Windows/Active Directory users.akas.co

Locate the setting in the list using the Search bar at the top right of akas-admin-settings.png.

Click the Edit (Pencil) icon on the left of the row.

Update the Value field according to the instructions in the Remark column.

Save your changes.

Use the Test Email or Broadcast Message buttons at the top of the screen to verify that your configuration is working as expected.