Starting and stopping Bitbucket Server
This page describes the various ways you can start or stop Bitbucket Server, depending on which method suits your needs.
Start Bitbucket during installation
The Bitbucket Server installer can automatically start Bitbucket Server. If you're not using the installer, use the instructions below that are appropriate for your needs to start Bitbucket.
On this page
Start/stop Bitbucket Server
To start/stop Bitbucket Server
For Linux
Change to your <Bitbucket Server installation directory>, then use the command that meets your needs:
bin/start-bitbucket.sh
bin/stop-bitbucket.shFor Windows
For automated starting and stopping of Bitbucket Server on Windows, it should be installed as a service.
You can use start-bitbucket.bat for short term debugging, using Ctrl+C will safely shutdown the instance when it is no longer needed.
For macOS
Use the app icons in the <Bitbucket Server installation directory>. These link to the start-bitbucket.sh and stop-bitbucket.sh scripts in <Bitbucket Server installation directory>/bin.
Start Bitbucket Data Center
For Bitbucket Data Center, the remote Elasticsearch instance must be started separately. It is a requirement of the Bitbucket Data Center setup that you have only one remote Elasticsearch instance for your entire cluster, as described on Installing Bitbucket Data Center. To start (or restart) a remote Elasticsearch instance, see Elasticsearch documentation for specific instructions.
To start Bitbucket Data Center (does not start Bitbucket's bundled Elasticsearch instance)
- Change to your
<Bitbucket Server installation directory> Run this command:
start-bitbucket.sh --no-search
Start/stop Bitbucket Server when running as a service
On Windows and Linux systems you can choose to have Bitbucket Server installed as a service, and it will be started automatically when the system boots.
To start/stop Bitbucket Server manually when running as service:
For Linux
Manage the Bitbucket Server service with these commands:
# service atlbitbucket status
# service atlbitbucket stop
# service atlbitbucket startIf you installed Bitbucket as a systemd service (as explained in Running Bitbucket Server as a Linux service), use these commands instead:
# systemctl bitbucket status
# systemctl bitbucket stop
# systemctl bitbucket startFor Windows
Start and stop the Bitbucket Server service from the services console, on Windows. Ensure you start both the AtlassianBitbucket and AtlassianBitbucketElasticsearch services.
Start Bitbucket Server without starting bundled Elasticsearch
To start Bitbucket Server without starting the bundled Elasticsearch instance
start-bitbucket.sh --no-search
For Windows
start-bitbucket.bat /no-search
For Docker installations, use the -e ELASTICSEARCH_ENABLED=false parameter. Learn more about deploying Bitbucket through Docker
Performing a graceful shutdown (Linux only)
You can send a SIGTERM signal to Bitbucket to trigger a graceful shutdown. This will give Bitbucket some time to complete any running tasks, in-flight GIT requests, and in-flight user requests before terminating. The bin/stop-bitbucket.sh script, service atlbitbucket stop command, and systemctl bitbucket stop SIGTERM signal to terminate Bitbucket.
During a graceful shutdown:
- Tomcat stops accepting new HTTP connections without interrupting active connections.
- The SSH server stop accepting new SSH connections without interrupting active connections.
- The job scheduler will not start any new jobs, but will not immediately cancel any running jobs.
The following config properties control how graceful shutdown works:
| Default value | Description |
graceful.shutdown.timeout | |
30 | The amount of time (in seconds) that Bitbucket should allocate before terminating all active HTTP requests, SSH requests, and running jobs. |
server.shutdown | |
graceful | Sets whether Bitbucket should initiate a graceful shutdown first upon termination. If you want Bitbucket to shut down immediately without waiting for any tasks to complete, set this to immediate. |
In addition to these config properties, the BITBUCKET_SHUTDOWN_TIMEOUT environment variable controls when Bitbucket terminates altogether. This environmental variable will override plugin.search.indexing.event.shutdown.timeout.
By default, BITBUCKET_SHUTDOWN_TIMEOUT is set to 40. We recommend you keep this environmental variable at least 10 seconds longer than plugin.search.indexing.event.shutdown.timeout.
Gracefull shutting down Docker deployments
If Bitbucket and ElasticSearch are running in the same container, you won't be able to trigger a graceful shutdown properly. We strongly recommend that you run ElasticSearch on its own separate container.
If ElasticSearch is not running on the same container, you can trigger a graceful Bitbucket shutdown through docker stop. This command will send a SIGTERM signal to Bitbucket.