On this page
Install on Linux/Unix
Step-by-step guide for installing and configuring BDIViz on Linux and Unix-based systems
Prerequisites
Before installing BDIViz on your Linux system, ensure you have the following prerequisites:
- A Linux distribution (Ubuntu, Debian, CentOS, etc.) with amd64 architecture
- Docker Engine installed and running (version 19.03 or later)
- At least 4GB of RAM and 10GB of free disk space
- Internet connection to pull the Docker image
Install Docker (if not already installed)
If you don’t have Docker installed, follow these steps to install it:
Run BDIViz Using Docker
Once Docker is installed and running, follow these steps to run BDIViz using the edenwu/bdi-viz-react:amd64 image:
1. Pull the Docker image
docker pull edenwu/bdi-viz-react:amd64
2. Run the container
docker run -d \
--name bdiviz \
-p 3000:3000 \
edenwu/bdi-viz-react:amd64
This will start the BDIViz container in detached mode and expose the web application at http://localhost:3000.
3. Verify the container is running
You can verify the container is up using:
docker ps
If everything is working correctly, you should see bdiviz
listed in the output.
4. Stop the container
When you’re done, you can stop the container with:
docker stop bdiviz
And if needed, remove it:
docker rm bdiviz
Note
- Make sure port
3000
is available on your host machine. - You can bind-mount local volumes or customize environment variables for advanced use (e.g., persistent storage, configuration injection).
- To update the image, simply pull the latest tag again and restart the container:
docker pull edenwu/bdi-viz-react:amd64 docker stop bdiviz && docker rm bdiviz docker run -d --name bdiviz -p 3000:3000 edenwu/bdi-viz-react:amd64
Troubleshooting
- Port already in use? Try using a different port:Then access it at http://localhost:8080.
docker run -d --name bdiviz-mac -p 8080:3000 edenwu/bdi-viz-react:arm64
- Docker daemon not running? Open Docker Desktop and make sure it’s active.
- Still stuck? Feel free to reach out or open an issue on the GitHub repository.