Showing results for 
Search instead for 
Did you mean: 
Sign up Log in
It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

How to upgrade bitbucket restore client


We're getting warning message as mentioned below, while running backup using bitbucket-backup-client.

"WARN         The current version of the restore client (3.3.3) lacks the necessary features to restore backups for Bitbucket 6.10.4. Backups will be performed successfully, but you must upgrade the restore client in order to restore them. To fail in this situation, please change the backup.requirerestorable property in"

So, I've downloaded the latest version of restore client .zip file from (which supports our bitbucket server version). After extracting the downloaded .zip file, I've used restore-client.jar file alone. Replaced the old restore-client.jar file with this new one with required file permission and restarted bitbucket service. 

Even after the above procedure, am still getting WARN message that am still using restore client (3.3.3). (- When running the backup again)

NOTE: I've not used latest backupclient.jar since it's running without issue. I've just replaced old restore-client.jar with new one. 

1 answer

0 votes
Jimmy Seddon Community Leader Dec 29, 2021

Hi @Gokul Deenadayalan,

I'll be honest I have never used the backup and restore client where I have simply replaced the restore client jar file alone.

I have always extracted the entire set.  While I don't think you need to take a new backup since you said it was working fine and the errors don't indicate it is having troubles with your backup file.  It might be worth doing a diff on the file as it was called out in the error message.

I'm wondering if there is something in that file that is making it think you are still using the older version.

I hope that helps!


@Jimmy Seddon  - Thanks for your response.

We didn't explicitly mentioned anything in backup-config.prop file. It's basically commented out since the clients are present in bitbucket-backup home directory itself.


# E.g. java -Dbitbucket.home=/path/to/bitbucket/home -jar <path/to/bitbucket-backup-client.jar>

# E.g. java -Dbitbucket.home=/path/to/restore/bitbucket/home -jar <path/to/bitbucket-restore-client.jar>

In fact, we didn't seen this WARN message till September. It began to show up all of sudden from October saying that "you need to upgrade restore client in order to restore them"

Jimmy Seddon Community Leader Dec 29, 2021

Interesting.  Did you happen to perform an upgrade of the server in October?  I know the backup utility is independent of the server upgrade so if you did, that would have been when you would have wanted to download the newer version of the backup utility.

Looking at  the docs for the backup utility, I saw there are instructions for enabling Debug logging.  That might help you get more information about the error you are receiving.

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Bitbucket

📣 Calling Bitbucket Data Center customers to participate in research

Hi everyone, Are you Bitbucket DC customer? If so, we'd love to talk to you! Our team wants to dive deep to understand your long-term plans regarding Bitbucket DC and Atlassian Cloud. Do you plan...

125 views 2 4
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you