Tool for generating PDF files from the backup. All backup formats are supported (Desktop, iOS, Android).
Please note that this tool is not for public use, but was rather developed for specific enterprise customers. However, we believe in open-source world, so if you manage to get it working, feel free to use it.
The latest stable version of the
tool:
. Please use this version as the tag for the docker image - quay.io/wire/backup-export-tool:<version>
. If you'd like to run the tool on
bare metal, download all assets on the release page.
See available docker image tags here on Quay.
How to generate PDF files using Desktop (or Web) app backup file
java -jar backup-export.jar \
web \
"mybackup.desktop_wbu" \
--email "dejan56@wire.com" \
--password "MyCoolPasswordForWire1"
There are two ways how to run the tool, using Docker (preferred) or Java.
One should use attached start.sh to run the tool. Fill variables first.
To run it manually inside the docker execute following:
docker run --rm -it \
-v </path/to/database/file>:/app/database-in \
-v </path/to/output/folder>:/app/database-out \
-e CLIENT_TYPE=<ios,android,web> \
-e WIRE_USER=<user-with-wire-account> \
-e WIRE_PASSWORD=<password-for-that-user> \
-e BACKUP_PASSWORD=<password-for-backup-file> \
-e BACKUP_USERNAME=<username-who-created-backup> \
-e WIRE_API_HOST=<url-to-wire-backend> \
-e USE_PROXY=true \
-e PROXY_URL=<proxy-url> \
-e PROXY_PORT=<proxy-port> \
-e NON_PROXY_HOSTS=<proxy-hosts> \
quay.io/wire/backup-export-tool:<version>
Where <some value>
should be replaced by your own value.
Following variables are optional:
PROXY_URL
,PROXY_PORT
,NON_PROXY_HOSTS
- proxy settings, use only if you need it, also if you specify these values, you must also add-e USE_PROXY=true
to activate proxyWIRE_API_HOST
- URL to Wire backend, default value is used Wire public cloudBACKUP_PASSWORD
andBACKUP_USERNAME
- use only ifCLIENT_TYPE
isios
orandroid
Example:
docker run --rm -it \
-v backups/dejan56.ios_wbu:/app/database-in \
-v backup-exports/dejan:/app/database-out \
-e CLIENT_TYPE=ios \
-e WIRE_USER=my-testing-user@wire.com \
-e WIRE_PASSWORD=VerySecretPassword1! \
-e BACKUP_PASSWORD=Monkey123! \
-e BACKUP_USERNAME=dejan56 \
quay.io/wire/backup-export-tool:2.0.0
One needs C library Libsodium installed. To install it, one should use official documentation, or to use included binaries. One should use Java 8 (OpenJDK) to run the tool, but Java 11 (OpenJDK) seems to be working as well. We observed some problems running the tool under Windows and Oracle JDK, thus OpenJDK is required.
Almost all parameters are set using arguments to the tool, however, in order to use different Wire backend, one must set environmental variable with backend URL:
WIRE_API_HOST=<your-wire-backend>
For example to set it on unix systems: export WIRE_API_HOST=https://staging-nginz-https.zinfra.io
for staging.
To create executable jar
please run ./gradlew shadowJar
which produces build/libs/backup-export.jar
.
Generic way how to run the tool is following:
java -Djna.library.path=<path-to-binaries> \
-Xmx4g \
-jar <path-to-jar> \
<ios,android,desktop> \
"</path/to/database/file>" \
--output "</path/to/output/folder>" \
--email "<user-with-wire-account>" \
--password "<password-for-that-user>" \
--username"<username-who-created-backup>" \
--backup-password "<password-for-backup-file>"
An example for iOS backup without proxy (the build is downloaded and extracted zip
from the release page)
java -Djna.library.path=libs \
-Xmx4g \
-jar backup-export.jar \
ios \
"backups/dejan56.ios_wbu" \
--output "dejans-export" \
--email "dejan56@wire.com" \
--password "MyCoolPasswordForWire1" \
--username "dejan56" \
--backup-password "AnotherCoolPasswordForBackups"
If one needs to use proxy, --use-proxy
must be set, see example:
java -Djna.library.path=libs \
-Xmx4g \
-jar backup-export.jar \
web \
"backups/Wire-fredjones_Demo_Backup.zip" \
--output "backup-exports" \
--email "dejan56@wire.com" \
--password "MyCoolPasswordForWire1" \
--use-proxy "true" \
--proxy-host "my-proxy-domain.com" \
--proxy-port 8080 \
--proxy-non-proxy-hosts "non-proxied-host.com"