An application for interacting with Azimuth.
The latest version of Bridge is accessible online at bridge.urbit.org. No setup needed.
If you would rather host Bridge on your own machine, read on.
Python 3.7.2
- Download a release
- Unzip it (
bridge-$version.zip
) - Open up your command line interface (Terminal on MacOS, Command Prompt on Windows)
cd
into thebridge-$version
directory
Optionally, to validate your downloaded file's integrity, compare the lines in checksum.txt to SHA-256 hashes of the bridge-$version
directory's contents.
- On MacOS:
shasum -a 256 -c checksums.txt .
- On Linux:
sha256sum -c checksums.txt .
- On Windows: Go into the
build
directory and verify files individually withCertUtil -hashFile [file_name] SHA256
cd
into thebridge-$version
directory- Run
python3 -m http.server 5000 --bind 127.0.0.1
- Navigate to http://localhost:5000 using a web browser to access Bridge (we recommend using Firefox or Chrome)
If you plan to authenticate with a Ledger, Bridge must be serving over HTTPS on localhost. This requires self-signed certificates. To do this:
- Install mkcert
- Install a local certificate authority via
mkcert -install
- From the
bridge-$version
directory, runmkcert localhost
to generate a certificate valid for localhost. This will produce two files:localhost.pem
, the local certificate, andlocalhost-key.pem
, its corresponding private key - Run
python bridge-https.py
- Navigate to https://localhost:4443 in a web browser to access Bridge
A proper "offline mode" for the latest iteration of Bridge is still being worked on. In the mean time, if you need to use Bridge on an airgapped machine, use Bridge v1.4.1.
See development.md.