---
name: "rabbitmq.conf"
section: "5"
platform: "linux"
package: "rabbitmq-server"
version: "1.8.1-1"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/rabbitmq.conf"
---

# rabbitmq.conf(5)

default settings for RabbitMQ AMQP server

## NAME

rabbitmq.conf - default settings for RabbitMQ AMQP server

## DESCRIPTION

/etc/rabbitmq/rabbitmq.conf contains variable settings that override the defaults built in to the RabbitMQ startup scripts.

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 "#".

In order of preference, the startup scripts get their values from the environment, from /etc/rabbitmq/rabbitmq.conf and finally from the built-in default values. For example, for the **RABBITMQ\_NODENAME** setting,

**RABBITMQ\_NODENAME**

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

**NODENAME**

from /etc/rabbitmq/rabbitmq.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.

The variable names in /etc/rabbitmq/rabbitmq.conf are always equal to the environment variable names, with the **RABBITMQ\_** prefix removed: **RABBITMQ\_NODE\_PORT** from the environment becomes **NODE\_PORT** in the /etc/rabbitmq/rabbitmq.conf file, etc.

```
# I am a complete /etc/rabbitmq/rabbitmq.conf file.
# Comment lines start with a hash character.
# This is a /bin/sh script file - use ordinary envt var syntax
NODENAME=hare
```

## SEE ALSO

[**rabbitmq-multi**(1)](/rabbitmq-multi/1.md) [**rabbitmq-server**(1)](/rabbitmq-server/1.md) [**rabbitmqctl**(1)](/rabbitmqctl/1.md)

## EXAMPLES

```
# I am a complete /etc/rabbitmq/rabbitmq.conf file.
# Comment lines start with a hash character.
# This is a /bin/sh script file - use ordinary envt var syntax
NODENAME=hare

```

This is an example of a complete /etc/rabbitmq/rabbitmq.conf file that overrides the default Erlang node name from "rabbit" to "hare".

## AUTHOR

**The RabbitMQ Team \<info@rabbitmq.com\>**