1.4. Installation on FreeBSD

Note

Be sure to create an admin user before starting CouchDB for the first time!

The following options for or /etc/rc.conf.local are supported by the start script (defaults shown):

After enabling the couchdb rc service use the following command to start CouchDB:

The start script will also use settings from the following config files:

• /usr/local/etc/couchdb/local.ini

Administrators should use default.ini as reference and only modify the file.

1.4.1.2. Post install

In case the install script fails to install a non-interactive user “couchdb” to be used for the database, the user needs to be created manually:

I used the pw command to add a user “couchdb” in group “couchdb”:

The user is added to /etc/passwd and should look similar to the following:

To change any of these settings, please refrain from editing /etc/passwd and instead use or vipw. Make sure that the user has no shell, but instead uses /usr/sbin/nologin. The ‘*’ in the second field means that this user can not login via password authorization. For details use man 5 passwd.