XUD UI
A graphical user interface for interacting with a xud-docker environment.
Features
- Connect to an existing xud-docker environment, local or remote
- Provides read-only views & downloads for
- services running in xud-docker
- wallets
- trade history
Getting started
-
Download and run the XUD UI executable. The latest release can be found here.
-
Make sure to have a xud-docker environment running with API enabled. You can do that by either entering the environment with bash xud.sh --proxy.disabled=false
or enabling the API permanently in mainnet.conf
:
[proxy]
disabled = false
expose-ports = ["8889"]
- The API is accessible via the following ports
- mainnet: 8889 (
localhost:8889
) - default
- testnet: 18889 (
localhost:18889
)
- simnet: 28889 (
localhost:28889
)
- If you are running xud-docker mainnet locally, XUD UI connects automatically to this instance
Application logs
Logs are written to the following locations
- on Linux: ~/.config/xud-ui/logs/
- on macOS: ~/Library/Logs/xud-ui/
- on Windows: %USERPROFILE%\AppData\Roaming\xud-ui\logs\
Application data
Application data is stored in the following locations
- on Linux: ~/.config/xud-ui/
- on macOS: ~/Library/Application\ Support/xud-ui/
- on Windows: %USERPROFILE%\AppData\Roaming\xud-ui\
Development
Requirements
Install dependencies
yarn
Start in development mode
Windows (Powershell)
($env:HTTPS = "true") -and (yarn start)
Linux, macOS (Bash)
HTTPS=true yarn start
Tests
yarn test
Lint
yarn lint
Building an executable
yarn build
to build for an OS the command is executed from.