🤖 For AI agents: The complete documentation index is available at /docs/llms.txt. A markdown version of this page is available at /docs/get-started/download-and-install/start-and-stop.md.

If you are self-hosting FusionAuth, you may need to manually start or stop FusionAuth periodically.

It is recommended you start the FusionAuth Search service before starting the FusionAuth App service. You should also shutdown the Search Engine last. FusionAuth utilizes the Search Engine and database for persisting and retrieving users.

The following examples will make the assumption that all of the services are running on the same server. Based upon how you have installed FusionAuth you may or may not have all of the services running on the same server.

The macOS and Windows instructions assume an installation directory of /usr/local/fusionauth and \fusionauth respectively. Please adjust to your specific installation directory. We'll refer to this directory as FUSIONAUTH_HOME.

FusionAuth installation using Debian or RPM packages also installs the fusionauth-search and fusionauth-app services. Use these services to start and stop FusionAuth.

To start FusionAuth:

$ sudo systemctl start fusionauth-search
$ sudo systemctl start fusionauth-app

To stop Fusionauth:

$ sudo systemctl stop fusionauth-app
$ sudo systemctl stop fusionauth-search

If you'd prefer to use the native Elastic and Tomcat scripts, follow the macOS instructions.

To start FusionAuth:

$ /usr/local/fusionauth/fusionauth-search/elasticsearch/bin/elasticsearch
$ /usr/local/fusionauth/fusionauth-app/bin/start.sh

To stop FusionAuth:

$ /usr/local/fusionauth/fusionauth-app/bin/stop.sh

Always stop Elasticsearch last. If you started Elasticsearch using the elasticsearch script, shut Elasticsearch down by closing that terminal window.

To start FusionAuth:

$ brew services start opensearch
$ brew services start fusionauth-app

To stop FusionAuth:

$ brew services stop fusionauth-app
$ brew services stop opensearch

On Windows, you can run FusionAuth using either native PowerShell scripts, or Windows services.

To start FusionAuth:

\fusionauth\fusionauth-search\elasticsearch\bin\elasticsearch.bat
\fusionauth\fusionauth-app\bin\start.ps1

To stop FusionAuth:

\fusionauth\fusionauth-app\bin\stop.ps1

Always stop Elasticsearch last. If you started Elasticsearch using the elasticsearch.bat script, shut it down by closing that command window.

To start FusionAuth:

net start FusionAuthSearch
net start FusionAuthApp

To stop FusionAuth:

net stop FusionAuthApp
net stop FusionAuthSearch