From BaseX Documentation
This article is part of the Advanced User's Guide. It gives some more insight into the configuration of BaseX.
 Configuration Files
BaseX maintains some configuration files, which are stored in the project’s Home Directory:
.basexcontains all options that are relevant for running the server or standalone versions of BaseX.
.basexguidefines all options relevant to the BaseX GUI.
.basexeventscontains all existing events (see Events).
.basexhistorycontains commands that have been typed in most recently.
.basexhomecan be created by a user to mark a folder as home directory. Its contents do not matter, so it is usually empty.
- Since Version 8.0, the
.basexpermfile is obsolete. Users are now stored in
users.xmlin the database directory (see User Management for more information).
Note that, depending on your OS and configuration, files and folders with a '.' prefix may be hidden.
 Home Directory
As BaseX is distributed in different flavors, and may be started from different locations, it dynamically determines its home directory:
- First, the system property
org.basex.pathis checked. If it contains a value, it is chosen as directory path.
- If not, the current user directory (defined by the system property
user.dir) is chosen if the
.basexhomefile is found in this directory.
- Otherwise, the files are searched in the application directory (the folder in which the BaseX code is located).
- In all other cases, the user's home directory (defined in
user.home) is chosen.
 Database Directory
A database in BaseX consists of several files, which are located in a directory named by the name of the database.
If the user’s home directory has been chosen as base directory, the database directories will be planed in a
BaseXData directory. Otherwise, the directory will be named
The database path can be changed as follows:
- GUI: Choose Options → Preferences and choose a new database path.
- General: edit the
DBPATHoption in the
Note: Existing databases will not be automatically moved to the new destination.
 Log Files
Log files are stored in text format in a
.logs sub-directory of the database folder (see Logging for more information).
- Version 8.0
- Version 7.7
- Updated: the
.basexhomefile marks a folder as home directory.