ArangoDB v3.12 is under development and not released yet. This documentation is not final and potentially incomplete.
Installing ArangoDB on Windows
You can use ArangoDB on Windows (64-bit) in different ways:
- Docker image
- Automated, using an installation wizard (“installer”)
- Manually, using a ZIP archive
Visit the official Download page of the ArangoDB web site.
You may verify the download by comparing the SHA256 hash listed on the website
to the hash of the file. For example, you can run
openssl sha256 <filename>
certutil -hashfile <filename> sha256 in a terminal.
The recommended way of using ArangoDB on Windows is to use the ArangoDB Docker images with, for instance, Docker Desktop.
You can choose one of the following:
arangodbofficial Docker images, verified and published by Docker.
arangodb/arangodbDocker images, maintained and directly published by ArangoDB on a regular basis.
The default installation directory is
%LOCALAPPDATA%\ArangoDB-3.x.x\ (single-user). You may change
it during the installation process. In the following description, it is assumed
that ArangoDB has been installed in the location
You have to be careful when choosing an installation directory. You need either write permission to this directory or you need to modify the configuration file for the server process. In the latter case the database directory and the Foxx directory have to be writable by the user.
There are two main modes for the installer of ArangoDB. The installer lets you select:
- Multi-user installation (default; admin privileges required). Installs ArangoDB as service.
- Single-user installation. Allows to install ArangoDB as normal user. Requires manual starting of the database server.
You can tick or untick the following checkboxes:
- Choose custom install paths
- Do an automatic upgrade
- Keep an backup of your data
- Add executables to path
- Create a desktop icon
This checkbox controls if you are able to override the default paths for the installation in subsequent steps.
The default installation paths are:
- Foxx Service:
- Foxx Service:
The environment variables are typically:
We are not using the roaming part of the user’s profile, because doing so avoids the data being synced to the windows domain controller.
If this checkbox is selected, the installer attempts to perform an automatic update. For more information, please see Upgrading on Windows.
Select this to create a backup of your database directory during automatic upgrade. The backup is created next to your current database directory suffixed by a time stamp.
Select this to add the binary directory to your system’s path (multi-user installation) or user’s path (single-user installation).
Select if you want the installer to create Desktop Icons that let you:
- access the web interface
- start the command-line client (arangosh)
- start the database server (single-user installation only)
If you installed ArangoDB for multiple users (as a service), it is automatically
started. Otherwise you need to use the shortcut that was created on your desktop
(depending on the installer settings) or by running the executable
<ROOTDIR>\usr\bin. It uses the configuration file
<ROOTDIR>\etc\arangodb3, which you can adjust to your needs.
Please check the output of the
arangod.exe executable before continuing.
If the server started successfully, you should see a line
ArangoDB is ready for business. Have fun! at the end of its output.
You can access the administration web interface by pointing your web browser to the following address:
If you want to provide your own start scripts, you can set the environment
ARANGODB_CONFIG_PATH. This variable should point to a directory
containing the configuration files.
To connect to an already running ArangoDB server instance, there is a shell
arangosh.exe located in
<ROOTDIR>\usr\bin. This starts a shell that can be
used – amongst other things – to administer and query a local or remote
arangosh.exe does NOT start a separate server, it only starts the
shell. To use it you must have a server running somewhere, e.g. by using
arangosh.exe uses the configuration from the file
arangosh.conf located in
<ROOTDIR>\etc\arangodb3\. Please adjust this to your needs if you want to
use different connection settings etc.
To uninstall the Arango server application you can use the windows control panel
(as you would normally uninstall an application). Note however, that any data
files created by the ArangoDB server as well as the
remain. To complete the uninstallation process, remove the data files and
<ROOTDIR> directory manually.
The NSIS-based installer requires user interaction by default, but it also offers a Silent Mode which allows you to run it non-interactively from the command line:
ArangoDB3-3.x.x_win64.exe /S ...
You can run the uninstaller in Silent Mode:
Uninstall.exe /S ...
All choices available in the GUI can be passed as arguments. The options can
be specified like
/PASSWORD- Set the password for the
rootuser. If this option is not set but a persistent environment variable
PASSWORDis, then its value is used as password.
/INSTDIR- Installation directory. A directory that you have access to.
/DATABASEDIR- Database directory. A directory that you have access to and the databases should be created in.
/APPDIR- Foxx Services directory. A directory that you have access to.
1- Install for all users, as well as install a Windows service called
arangodband launch it.
0- Install for the current user only. Does not start the server automatically, but creates a shortcut on the desktop to start it.
0- Do not create any shortcuts
1- Create shortcuts on the desktop for arangosh and the web interface
1- Automatically upgrade existing ArangoDB databases
0- No upgrade of databases
1- Keep a backup of the databases if
0- No backup
0- Do not add ArangoDB to the PATH environment variable
/INSTALL_SCOPE_ALL=1: add it to the path for all users
/INSTALL_SCOPE_ALL=0: add it to the path of the currently logged in users
0- Database files remain on the system
1- Database files ArangoDB created during its lifetime are removed, too.
Not all users prefer the guided Installer to install ArangoDB. In order to have a portable application, or easily start different ArangoDB versions on the same machine, and/or for the maximum flexibility, you might want to install using the ZIP archive ( XCOPY deployment).
Open an explorer, choose a place where you would like ArangoDB to be, and extract the archive there. It creates its own top-level directory with the version number in the name.
This step is optional.
If the default configuration of ArangoDB does not suite your needs,
you can edit
etc\arangodb3\arangod.conf to change or add configuration options.
After installation, you may start ArangoDB in several ways. The exact start-up command depends on the type of ArangoDB deployment you are interested in (Single Instance, Active Failover or Cluster).
Please refer to the Deployment chapter for details.