1.2. Installation on Windows¶
There are two ways to install CouchDB on Windows.
1.2.1. Installation from binaries¶
This is the simplest way to go.
Warning
Windows 8, 8.1, and 10 require the .NET Framework v3.5 to be installed.
- Get the latest Windows binaries from the CouchDB web site. Old releases are available at archive.
- Follow the installation wizard steps. Be sure to install CouchDB to a
path with no spaces, such as
C:\CouchDB. - Your installation is not complete. Be sure to complete the Setup steps for a single node or clustered installation.
- Open up Fauxton
- It’s time to Relax!
Note
In some cases you might been asked to reboot Windows to complete installation process, because of using on different Microsoft Visual C++ runtimes by CouchDB.
Note
Upgrading note
It’s recommended to uninstall previous CouchDB version before upgrading, especially if the new one is built against different Erlang release. The reason is simple: there may be leftover libraries with alternative or incompatible versions from old Erlang release that may create conflicts, errors and weird crashes.
In this case, make sure you backup of your local.ini config and CouchDB database/index files.
1.2.1.1. Silent Install¶
The Windows installer supports silent installs. Here are some sample commands, supporting the new features of the 3.0 installer.
Install CouchDB without a service, but with an admin user:password of admin:hunter2:
msiexec /i apache-couchdb-3.0.0.msi /quiet ADMINUSER=admin ADMINPASSWORD=hunter2 /norestart
The same as above, but also install and launch CouchDB as a service:
msiexec /i apache-couchdb-3.0.0.msi /quiet INSTALLSERVICE=1 ADMINUSER=admin ADMINPASSWORD=hunter2 /norestart
Unattended uninstall of CouchDB:
msiexec /x apache-couchdb-3.0.0.msi /quiet /norestart
Unattended uninstall if the installer file is unavailable:
msiexec /x {4CD776E0-FADF-4831-AF56-E80E39F34CFC} /quiet /norestart
Add /l* log.txt to any of the above to generate a useful logfile for debugging.