Linking other devices (Provisioning)

• Connect to another device

  signal-cli link -n "optional device name"
  

  This shows a tsdevice:/… link; if you want to connect to another signal-cli instance, you can just use this link. If you want to link to an Android device, create a QR code with the link (e.g. with qrencode) and scan that in the Signal Android app.

  To request a link and display the resulting QR code image in a single command on linux:

  signal-cli link -n "optional device name" | xargs -l qrencode -o /tmp/qrcode.png & while [ ! -f /tmp/qrcode.png ]; do sleep 1; done; xdg-open /tmp/qrcode.png
  

  Do not kill the signal-cli link … process until linking is finished; the process will exit when it's done.

  After linking was successful, you need to execute the receive command to get the list of contacts and groups from the main device.

  signal-cli -u USERNAME receive
  

  For a tutorial for linux see: https://mark.benschop.me/blog/?p=122 (uses qrencode)

• Add another device

  signal-cli -u USERNAME addDevice --uri "tsdevice:/…"
  

  The "tsdevice:/…" link is the one shown by the new signal-cli instance or contained in the QR code shown in Signal-Desktop or similar apps.

  Only the master device (that was registered directly, not linked) can add new devices.

• Manage linked devices

  signal-cli -u USERNAME listDevices
  
  signal-cli -u USERNAME removeDevice -d DEVICE_ID