Running Bitbucket Server with a dedicated user

For production installations, we recommend that you create a new dedicated user that will run Bitbucket Server on your system. This user:

  • Should be local.
  • Should not have admin privileges.
  • Should be a non-privileged user with read, write, modify and execute access (called "Full control" permission on Windows) on the Bitbucket Server install directory and home directory.

Note that, on Windows, running Bitbucket Server (whether as a service, or not) as a user that is part of the Administrator group can cause Windows to spend a lot of time running permission checks, with a consequent performance impairment for Git operations.

See also Running Bitbucket Server as a Windows service and Run Bitbucket as a Linux service.

For Linux, here is an example of how to create a dedicated user to run Bitbucket Server:

$ sudo /usr/sbin/useradd --create-home --home-dir /opt/atlassian/bitbucket --shell /bin/bash atlbitbucket

On Windows, the user must be a member of the Performance Monitor Users group.

Last modified on Jun 21, 2021

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.