File System Layout

››

File System Layout

The directory locations outlined below are used to store MailArchiva's configuration, application and logging data.

Server Configuration: MailArchiva's entire server configuration is maintained in a file called server.conf. The server.conf file can be edited using any text editor and is located in the configuration directory indicated below.

Logging Data: MailArchiva's server logs comprise of both a core and an instance debug.log file. It is separated out this way, since the product is multi-tenant. If you experience problems with the server, view the contents of the two debug.log files to troubleshoot problems. Each debug.log file is located in both the core (e.g. C:\ProgramData\MailArchiva\core\..) and instance (e.g. C:\ProgramData\MailArchiva\ROOT\..) locations.

MailArchiva v3.0+

WARNING!! Do not leave backup copies of directories and files lying around in the [instances] and [main application]\server\webapps directories. Doing so, will cause system instability and may result in data loss.

Windows 7-11 / Server 2008-2024

Folder	Use
C:\Program Files\MailArchiva	app server
C:\ProgramData\MailArchiva\core\logs\debug	core debug log
C:\ProgramData\MailArchiva\ROOT\logs\debug	main instance debug log
C:\ProgramData\MailArchiva\	instances
C:\ProgramData\MailArchiva\ROOT\logs\audit	main instance audit log
C:\ProgramData\MailArchiva\ROOT\conf	main instance configuration
C:\ProgramData\MailArchiva\ROOT	main instance application data
C:\ProgramData\MailArchiva\Tomcat	app server configuration
C:\ProgramData\MailArchiva\Tomcat\webapps\ROOT	web application

Windows XP / Server 2003

Folder	Use
C:\Program Files\MailArchiva	app server
C:\Documents And Settings\All Users\Application Data\MailArchiva\	instances
C:\Documents And Settings\All Users\Application Data\MailArchiva\core\logs\debug	core debug log
C:\Documents And Settings\All Users\Application Data\MailArchiva\ROOT\logs\debug	main instance debug log
C:\Documents And Settings\All Users\Application Data\MailArchiva\ROOT\logs\audit	main instance audit log
C:\Documents And Settings\All Users\Application Data\MailArchiva\ROOT\conf	main instance configuration
C:\Documents And Settings\All Users\Application Data\MailArchiva\ROOT	main instance application data
C:\Documents And Settings\All Users\Application Data\MailArchiva\Tomcat	app server configuration
C:\Documents And Settings\All Users\Application Data\MailArchiva\Tomcat\webapps\ROOT	web application

Linux

Folder	Use
/opt/mailarchiva	app server
/var/log/mailarchiva/core/debug	core debug log files
/var/log/mailarchiva/ROOT/debug	main instance debug log files
/var/log/mailarchiva/ROOT/audit	main instance audit log files
/etc/opt/mailarchiva	instances
/etc/opt/mailarchiva/ROOT	main instance configuration
/var/opt/mailarchiva/ROOT	main instance application data
/var/opt/mailarchiva/tomcat	app server configuration
/var/opt/mailarchiva/tomcat/webapps/ROOT	web application

OS X

Folder

Use

/Applications/MailArchiva.app/

app server

/Library/Logs/MailArchiva/core/debug

core debug log

/Library/Logs/MailArchiva/ROOT/debug

main instance debug log

/Library/Logs/MailArchiva/ROOT/audit

main instance audit log

/Library/Application Support/MailArchiva

instances

/Library/Application Support/MailArchiva/ROOT/conf

main instance configuration

/Library/Application Support/MailArchiva/ROOT

main instance application data

/Library/Application Support/MailArchiva/Tomcat/webapps/ROOT

web application

Solaris

Folder	Use
/opt/mailarchiva	app server
/var/log/mailarchiva/core/debug	core debug log files
/var/log/mailarchiva/ROOT/debug	main instance debug log files
/var/log/mailarchiva/audit	main instance audit log files
/etc/opt/mailarchiva	instances
/etc/opt/mailarchiva/ROOT	main instance configuration
/var/opt/mailarchiva/ROOT	main instance application data
/var/opt/mailarchiva/tomcat/	app server configuration
/var/opt/mailarchiva/tomcat/webapps/ROOT	web application

MailArchiva v2.0

Location	Configuration
C:\Program Files\MailArchiva\server\webapps\ROOT\WEB-INF\conf\* (Windows) /usr/local/mailarchiva/server/webapps/ROOT/WEB-INF/conf/* (Linux)	Configuration Files
C:\Program Files\MailArchiva\server\webapps\ROOT\WEB-INF\classes\log4j.xml (Windows) /usr/local/mailarchiva/server/webapps/ROOT/WEB-INF/classes/log4j.xml (Linux)	Logging Configuration
C:\Program Files\MailArchiva\server\webapps\ROOT\WEB-INF\classes\license.lic (Windows) /usr/local/mailarchiva/server/webapps/ROOT/WEB-INF/classes/license.lic (Linux)	License
C:\Program Files\MailArchiva\server\webapps\ROOT\WEB-INF\logs\* (Windows) /usr/local/mailarchiva/server/webapps/ROOT/WEB-INF/logs/index* (Linux)	Logs

Was this helpful?

Thank you Your feedback helps us to continually improve our content.

Found this information useful? Visit mailarchiva.com to learn more about MailArchiva.