'\" t

.\"     Title: rabbitmq-env.conf

.\"    Author: The RabbitMQ Team <[email protected]>

.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>

.\"      Date: 05/10/2013

.\"    Manual: RabbitMQ Server

.\"    Source: RabbitMQ Server

.\"  Language: English

.\"

.TH "RABBITMQ\-ENV\&.CONF" "5" "05/10/2013" "RabbitMQ Server" "RabbitMQ Server"

.\" -----------------------------------------------------------------

.\" * set default formatting

.\" -----------------------------------------------------------------

.\" disable hyphenation

.nh

.\" disable justification (adjust text to left margin only)

.ad l

.\" -----------------------------------------------------------------

.\" * MAIN CONTENT STARTS HERE *

.\" -----------------------------------------------------------------

.SH "NAME"

rabbitmq-env.conf \- default settings for RabbitMQ AMQP server

.SH "DESCRIPTION"

.PP

/etc/rabbitmq/rabbitmq\-env\&.conf

contains variable settings that override the defaults built in to the RabbitMQ startup scripts\&.

.PP

The file is interpreted by the system shell, and so should consist of a sequence of shell environment variable definitions\&. Normal shell syntax is permitted (since the file is sourced using the shell "\&." operator), including line comments starting with "#"\&.

.PP

In order of preference, the startup scripts get their values from the environment, from

/etc/rabbitmq/rabbitmq\-env\&.conf

and finally from the built\-in default values\&. For example, for the

\fBRABBITMQ_NODENAME\fR

setting,

.PP

\fBRABBITMQ_NODENAME\fR

.PP

from the environment is checked first\&. If it is absent or equal to the empty string, then

.PP

\fBNODENAME\fR

.PP

from

/etc/rabbitmq/rabbitmq\-env\&.conf

is checked\&. If it is also absent or set equal to the empty string then the default value from the startup script is used\&.

.PP

The variable names in /etc/rabbitmq/rabbitmq\-env\&.conf are always equal to the environment variable names, with the

\fBRABBITMQ_\fR

prefix removed:

\fBRABBITMQ_NODE_PORT\fR

from the environment becomes

\fBNODE_PORT\fR

in the

/etc/rabbitmq/rabbitmq\-env\&.conf

file, etc\&.

.sp

.fi

.SH "SEE ALSO"

.PP

\fBrabbitmq-server\fR(1)

\fBrabbitmqctl\fR(1)

.SH "EXAMPLES"

.sp

.nf

      \fB

# I am a complete /etc/rabbitmq/rabbitmq\-env\&.conf file\&.

# Comment lines start with a hash character\&.

# This is a /bin/sh script file \- use ordinary envt var syntax

NODENAME=hare

        \fR

.fi

.PP

This is an example of a complete

/etc/rabbitmq/rabbitmq\-env\&.conf

file that overrides the default Erlang node name from "rabbit" to "hare"\&.

.SH "AUTHOR"

.PP

\fBThe RabbitMQ Team <\fR\fB\fBinfo@rabbitmq\&.com\fR\fR\fB>\fR