Sphinx Chat Greenlight

What you need:

Raspberry Pi 4 or Zero

Micro SD (XXGB Min)

You do not need:

External hard drive

Getting Started

STEP 1 of 9
Grab our installer zip file from here. See the file integrity section below if you’d like to cross check this file.

STEP 2 of 9
Flash our installer onto your raspberry pi using your preferred method. We like to use the Raspberry Pi Imager, which you can download here.

First insert the SD Card you will use into your computer.

Launch the Raspberry Pi Imager, and click on the button “CHOOSE OS”.

Scroll down through the options available, and select “Use custom”. Using the dialog that follows, select the image that you have downloaded in step 1.

Next, click on the button “CHOOSE STORAGE”.

Select the SD card you previously inserted into your computer.

Click on the button “WRITE”.

Ensure that you do not have any important information on the SD card as its contents are going to be COMPLETELY ERASED. Then click on the button “YES” in the pop-up that follows.

Wait for the image to be written to the SD Card.

Wait for the program to verify that the image has been written correctly to the SD card.


STEP 3 of 9
If you are connecting your raspberry pi wirelessly to your internet router, reinsert your SD card into your computer, and follow the instructions here to set up your raspberry pi's connection.

STEP 4 of 9
First, create an empty file at the base of the boot partition of the raspberry pi. The quickest way to do this in Linux / MacOS is to open a terminal, and use the command touch ssh while standing in the boot directory.

STEP 5 of 9

In that same directory, write a file called `wpa_supplicant.conf`, with the name of your Wifi, and the password. See the example below for the correct formatting. Also use the following country codes for these countries: United Kingdom - “GB”, France - “FR”, Germany - “DE”, United States - “US”, Sweden - “SE”.

ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
country=<Insert 2 letter ISO 3166-1 country code here>

ssid="<Name of your wireless LAN>"
psk="<Password for your wireless LAN>"

STEP 6 of 9
Eject your sd card

STEP 7 of 9
Place your sd card into the raspberry pi, and plug the pi into a power source.

STEP 8 of 9
Wait around 5 minutes.

STEP 9 of 9
If you are on Linux/MacOS load the page
http://raspberrypi.local:3001/connect and if you are on Windows, load the page http://raspberrypi:3001/connect. Follow the instructions there.

When you can, SSH into your raspberry pi using the username pi and the password raspberry, and change the password with the command passwd

ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
country=[Insert 2 letter ISO 3166-1 country code here] update_config=1

ssid=”[Name of your wireless LAN]”
psk=”[Password for your wireless LAN]”


File Integrity

The sha256 of the zip file you will download from us is the following:


On macOS, you can check it by running this command in the directory where you have the file:

shasum -a 256 sphinx_greenlight_0_5.img.zip

Backing Up Your Funds and Data

All you need to do is backup the file home/pi/sphinx.db and the file home/pi/sphinx-relay/creds/hsm_secret

Unlike a lightning node, these files do not backup the state of your channels - they backup your sphinx chat data and the secret from which all your bitcoin keys are derived.

Using the app outside the home network

Here's how you can connect your sphinx chat app to your raspberry pi at home.

  1. Before anything, note that your app talks to your raspberry pi over http. All message payloads are encrypted, but the metadata is sent in plaintext to sphinx-relay. So if you'd like to set up https, you can find instructions here.
  2. Tell your router to forward all traffic on port 3001 to your raspberry pi.
  3. Set up a dynamic DNS service and point it to your router. We like to use dynDNS.
  4. Go to the advanced page in your sphinx chat app, and point the server setting to the domain name provided by your dynamic DNS service.
  5. Done! Congratulations, you are now able to use your sphinx chat app wherever you go!

Get your questions answered in the Greenlight Tribe right here!