summaryrefslogtreecommitdiff
path: root/docs/rabbitmq-server.1.xml
blob: a0458c93ee4486fe85a84580da7221d797a6632a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.docbook.org/xml/4.5/docbookx.dtd">
<refentry lang="en">
    <refentryinfo>
        <productname>RabbitMQ Server</productname>
        <authorgroup>
            <corpauthor>The RabbitMQ Team &lt;<ulink url="mailto:info@rabbitmq.com"><email>info@rabbitmq.com</email></ulink>&gt;</corpauthor>
        </authorgroup>
    </refentryinfo>

    <refmeta>
        <refentrytitle>rabbitmq-server</refentrytitle>
        <manvolnum>1</manvolnum>
        <refmiscinfo class="manual">RabbitMQ Server</refmiscinfo>
    </refmeta>

    <refnamediv>
        <refname>rabbitmq-server</refname>
        <refpurpose>start RabbitMQ AMQP server</refpurpose>
    </refnamediv>

    <refsynopsisdiv>
        <cmdsynopsis>
          <command>rabbitmq-server</command>
          <arg choice="opt">-detached</arg>
        </cmdsynopsis>
    </refsynopsisdiv>

    <refsect1>
        <title>Description</title>
        <para>
           RabbitMQ is an implementation of AMQP, the emerging standard for high
performance enterprise messaging. The RabbitMQ server is a robust and
scalable implementation of an AMQP broker.
        </para>
        <para>
Running rabbitmq-server in the foreground displays a banner message,
and reports on progress in the startup sequence, concluding with the
message "broker running", indicating that the RabbitMQ broker has been
started successfully. To shut down the server, just terminate the
process or use rabbitmqctl(1).
        </para>
    </refsect1>

    <refsect1>
      <title>Environment</title>
      <variablelist>

        <varlistentry>
          <term>RABBITMQ_MNESIA_BASE</term>
          <listitem>
            <para>
Defaults to <filename>/var/lib/rabbitmq/mnesia</filename>. Set this to the directory where
Mnesia database files should be placed.
            </para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>RABBITMQ_LOG_BASE</term>
          <listitem>
            <para>
Defaults to <filename>/var/log/rabbitmq</filename>. Log files generated by the server will
be placed in this directory.
            </para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>RABBITMQ_NODENAME</term>
          <listitem>
            <para>
Defaults to rabbit. This can be useful if you want to run more than
one node per machine - <envar>RABBITMQ_NODENAME</envar> should be unique per
erlang-node-and-machine combination. See the
<ulink url="http://www.rabbitmq.com/clustering.html#single-machine">clustering on a single
machine guide</ulink> for details.
            </para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>RABBITMQ_NODE_IP_ADDRESS</term>
          <listitem>
            <para>
By default RabbitMQ will bind to all interfaces, on IPv4 and IPv6 if
available. Set this if you only want to bind to one network interface
or address family.
            </para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>RABBITMQ_NODE_PORT</term>
          <listitem>
            <para>
Defaults to 5672.
            </para>
          </listitem>
        </varlistentry>

      </variablelist>
    </refsect1>

    <refsect1>
      <title>Options</title>
      <variablelist>
        <varlistentry>
          <term>-detached</term>
          <listitem>
            <para>
              start the server process in the background
            </para>
            <para role="example-prefix">For example:</para>
            <screen role="example">rabbitmq-server -detached</screen>
            <para role="example">
              Runs RabbitMQ AMQP server in the background.
            </para>
          </listitem>
        </varlistentry>
      </variablelist>
    </refsect1>

    <refsect1>
        <title>See also</title>
        <para>
            <citerefentry><refentrytitle>rabbitmq-env.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>
            <citerefentry><refentrytitle>rabbitmq-multi</refentrytitle><manvolnum>1</manvolnum></citerefentry>
            <citerefentry><refentrytitle>rabbitmqctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>
        </para>
    </refsect1>
</refentry>