.\" Text automatically generated by txt2man
.TH basexserver 1 "19 April 2022" "" "The XML Database"
.SH NAME
\fBbasexserver \fP- XML database system and XPath/XQuery processor (server mode)
\fB
.SH SYNOPSIS
.nf
.fam C
\fBbasexsercer\fP [\fB-cdhlnpsSUz\fP] [\fIstop\fP]

.fam T
.fi
.fam T
.fi
.SH DESCRIPTION
basexserver starts the server mode of the native XML database system \fBbasex\fP(1) on default port 1984.
.SH OPTIONS
A short description of option can be obtained from
.PP
.nf
.fam C
    $ basexserver \-h

.fam T
.fi
or by browsing https://docs.basex.org/wiki/Command-Line_Options#HTTP_Server
.SH USER MANAGEMENT
On first startup a user 'admin' with default password 'admin' exists (make sure to change this)!
.PP
Admin permissions are needed to execute one of the following processes.
.IP \(bu 3
Creating user 'test' with password 'test':
.PP
.nf
.fam C
   > CREATE USER test test

.fam T
.fi
As global permissions valid options are 'none', 'read', 'write', 'create' and 'admin'.
.IP \(bu 3
Revoking all global permissions from user 'test':
.PP
.nf
.fam C
   > GRANT none TO test

.fam T
.fi
Valid local permissions are 'none', 'read' and 'write'.
.IP \(bu 3
Granting write permission on database 'factbook' to user 'test':
.PP
.nf
.fam C
    > GRANT write ON factbook TO test

.fam T
.fi
Note: Local permissions overwrite global permissions. As a consequence, the 'test' user will only be allowed to access (i.e., read and write) the 'factbook' database. If no local permissions are set, the global rights are inherited.
.IP \(bu 3
Showing global permissions:
.PP
.nf
.fam C
    > SHOW USERS

.fam T
.fi
.IP \(bu 3
Showing local permissions on database 'factbook':
.PP
.nf
.fam C
   > SHOW USERS ON factbook

.fam T
.fi
.IP \(bu 3
Dropping of user 'test':
.PP
.nf
.fam C
   > DROP USER test

.fam T
.fi
Further details on user management are to be found in the BaseX Documentation
Wiki (https://docs.basex.org/wiki/User_Management).
.SH DATABASE COMMANDS
A list of supported Database commands can be obtained from
.PP
.nf
.fam C
    $ basexserver \-ic help

.fam T
.fi
or by browsing https://docs.basex.org/wiki/Commands
.SH SEE ALSO
\fBbasexclient\fP(1), \fBbasex\fP(1), \fBbasexgui\fP(1)
.PP
.nf
.fam C
   .basexhome                can be created by a user to mark a folder as home directory.
   .basex                    BaseX (standalone and server) properties
   .basexgui                 BaseX additional GUI properties 
   .basexhistory             contains commands that have been typed in most recently.
   ${basexhome}/data         Default database directory
   ${basexhome}/data/.logs   Server logs
   ${basexhome}/repo         Package repository

.fam T
.fi
BaseX Documentation Wiki: https://docs.basex.org
.SH HISTORY
BaseX started as a research project of the Database and Information Systems
Group (DBIS) at the University of Konstanz in 2005 and soon turned into a
feature-rich open source XML database and XPath/XQuery processor.
.SH LICENSE
New (3-clause) BSD License
.SH AUTHOR
BaseX is primarily developed by Christian Gruen <cg@basex.org> with
the help of various contributors <https://basex.org/about/open-source/>
.PP
The man page was written by Alexander Holupirek <alex@holupirek.de> while packaging BaseX for Debian GNU/Linux.