.\" vim:ft=nroff:
.\" The contents of this file are subject to the Mozilla Public License
.\" Version 1.1 (the "License"); you may not use this file except in
.\" compliance with the License. You may obtain a copy of the License
.\" at https://www.mozilla.org/MPL/
.\"
.\" Software distributed under the License is distributed on an "AS IS"
.\" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
.\" the License for the specific language governing rights and
.\" limitations under the License.
.\"
.\" The Original Code is RabbitMQ.
.\"
.\" The Initial Developer of the Original Code is Pivotal Software, Inc.
.\" Copyright (c) 2007-2020 VMware, Inc. or its affiliates.  All rights reserved.
.\"
.Dd September 28, 2019
.Dt RABBITMQ-SERVER 8
.Os "RabbitMQ Server"
.Sh NAME
.Nm rabbitmq-server
.Nd starts a RabbitMQ node
.\" ------------------------------------------------------------------
.Sh SYNOPSIS
.\" ------------------------------------------------------------------
.Nm
.Op Fl detached
.\" ------------------------------------------------------------------
.Sh DESCRIPTION
.\" ------------------------------------------------------------------
RabbitMQ is an open source multi-protocol messaging broker.
.Pp
Running
.Nm
starts a RabbitMQ node in the foreground. The node will display a startup
banner and report when startup is complete.
To shut down the server, use service management tools or
.Xr rabbitmqctl 8 .
.\" ------------------------------------------------------------------
.Sh ENVIRONMENT
.\" ------------------------------------------------------------------
.Bl -tag -width Ds
.It Ev RABBITMQ_CONFIG_FILE
Defaults to
.Pa /etc/rabbitmq/rabbitmq.conf .
Node configuration file path.
To learn more, see the
.Lk https://www.rabbitmq.com/configure.html "RabbitMQ Configuration guide"
.It Ev RABBITMQ_MNESIA_BASE
Defaults to
.Pa /var/lib/rabbitmq/mnesia .
Node data directory will be located (or created) in this directory.
To learn more, see the
.Lk https://www.rabbitmq.com/relocate.html "RabbitMQ File and Directory guide"
.It Ev RABBITMQ_LOG_BASE
Defaults to
.Pa /var/log/rabbitmq .
Log files generated by the server will be placed in this directory.
To learn more, see the
.Lk https://www.rabbitmq.com/logging.html "RabbitMQ Logging guide"
.It Ev RABBITMQ_NODENAME
Defaults to
.Qq rabbit@ .
followed by the computed hostname.
Can be used to run multiple nodes on the same host.
Every node in a cluster must have a unique
.Ev RABBITMQ_NODENAME
To learn more, see the
.Lk https://www.rabbitmq.com/clustering.html "RabbitMQ Clustering guide"
.It Ev RABBITMQ_NODE_IP_ADDRESS
By default RabbitMQ will bind to all IPv6 and IPv4 interfaces available.
This variable limits the node to one network interface or address
family.
To learn more, see the
.Lk https://www.rabbitmq.com/networking.html "RabbitMQ Networking guide"
.It Ev RABBITMQ_NODE_PORT
AMQP 0-9-1 and AMQP 1.0 port. Defaults to 5672.
To learn more, see the
.Lk https://www.rabbitmq.com/networking.html "RabbitMQ Networking guide"
.El
.\" ------------------------------------------------------------------
.Sh OPTIONS
.\" ------------------------------------------------------------------
.Bl -tag -width Ds
.It Fl detached
Start the server process in the background.
Note that this will cause the pid not to be written to the pid file.
.Pp
For example, runs RabbitMQ AMQP server in the background:
.sp
.Dl rabbitmq-server -detached
.El
.\" ------------------------------------------------------------------
.Sh SEE ALSO
.\" ------------------------------------------------------------------
.Xr rabbitmqctl 8 ,
.Xr rabbitmq-diagnostics 8 ,
.Xr rabbitmq-plugins 8 ,
.Xr rabbitmq-queues 8 ,
.Xr rabbitmq-upgrade 8 ,
.Xr rabbitmq-service 8 ,
.Xr rabbitmq-env.conf 5 ,
.Xr rabbitmq-echopid 8
.\" ------------------------------------------------------------------
.Sh AUTHOR
.\" ------------------------------------------------------------------
.An The RabbitMQ Team Aq Mt info@rabbitmq.com