Start and Stop FusionAuth
Start and Stop FusionAuth
If you are using the FusionAuth server version, may need to manually start or stop FusionAuth periodically. If you find yourself in this situation you’ll be glad you know how.
Unless you are hosting and managing FusionAuth these instructions do not apply to you. FusionAuth manages and monitors instances hosted in our private cloud and will restart FusionAuth if necessary.
Note that you MUST start the FusionAuth Search 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
.
Linux
When you install FusionAuth using our Debian or RPM packages a service is registered. It is recommended you utilize these services to start and stop FusionAuth.
The service names are as follows:
-
fusionauth-search
-
fusionauth-app
sudo systemctl start fusionauth-search
sudo systemctl start fusionauth-app
sudo systemctl stop fusionauth-app
sudo systemctl stop fusionauth-search
If you’d prefer to use the native Elastic and Tomcat scripts you may follow the macOS instructions, the same scripts may be executed on Linux.
macOS
Start and Stop services using the native Elastic and Tomcat scripts
/usr/local/fusionauth/fusionauth-search/elasticsearch/bin/elasticsearch
/usr/local/fusionauth/fusionauth-app/apache-tomcat/bin/catalina.sh start
/usr/local/fusionauth/fusionauth-app/apache-tomcat/bin/catalina.sh stop
Elasticsearch should be stopped last. If you started Elasticsearch using the elasticsearch
script then you may simply kill the terminal where
the service is running to initiate shutdown.
Windows
Start and Stop services using the native Elastic and Tomcat scripts
\fusionauth\fusionauth-search\elasticsearch\bin\elasticsearch.bat
\fusionauth\fusionauth-app\apache-tomcat\bin\catalina.bat start
\fusionauth\fusionauth-app\apache-tomcat\bin\catalina.bat stop
Elasticsearch should be stopped last. If you started Elasticsearch using the elasticsearch.bat
script then you may simply close the command
window where the service is running to initiate shutdown.
Start and Stop services using Windows Services
We also provide support for running FusionAuth as a Windows service.
\fusionauth\fusionauth-search\elasticsearch\bin\FusionAuthSearch.exe /install
\fusionauth\fusionauth-app\apache-tomcat\bin\FusionAuthApp.exe /install
\fusionauth\fusionauth-app\apache-tomcat\bin\FusionAuthApp.exe /uninstall
\fusionauth\fusionauth-search\elasticsearch\bin\FusionAuthSearch.exe /uninstall
net start FusionAuthSearch
net start FusionAuthApp
net stop FusionAuthApp
net stop FusionAuthSearch