Docker Setup Demo
To get started with the eIOU protocol, you'll need to set up Docker on your system. This demo will walk you through the process step by step.
Prerequisites
- Docker installed on your system
- Basic understanding of command line operations
💡 Quickstart Feature
New! Use the QUICKSTART environment variable
to automatically generate a wallet when starting a container. This runs
eiou generate http://$QUICKSTART automatically, making setup
faster for beginners.
Installation Steps
- Install Docker on your system if you haven't already (troubleshoot installation issues)
- Download and load the eIOU Docker image
- Run the container with the appropriate configuration
- Verify the installation
Docker Commands
Step 1: Download the eIOU Image
Option A: Download via Browser
You can download the Docker image directly in your browser:
After downloading, navigate to your Downloads folder:
Windows:
cd $HOME\Downloads Unix/Linux/macOS:
cd ~/Downloads Option B: Download via Command Line
Unix/Linux/macOS:
curl -L -o eioud-20250729_2.tar https://images.eiou.org/demo/eioud-20250729_2.tar Windows PowerShell:
Invoke-WebRequest -Uri https://images.eiou.org/demo/eioud-20250729_2.tar -OutFile eioud-20250729_2.tar Step 2: Load the Docker Image
docker load -i eioud-20251204.tar Step 3: Create a Private Network
docker network create eiou-network Step 4: Run the eIOU Container
Note: In this tutorial, we use the names Alice, Bob, Carol, and Daniel to represent different users or nodes in the eIOU network. This makes it easier to understand how the protocol works with multiple participants.
Option A: Quickstart Setup (Recommended for Beginners)
This option automatically runs the generate command to create a wallet for you:
docker run -d --name Alice --network eiou-network -e QUICKSTART=Alice eioud The QUICKSTART environment variable will automatically execute "eiou generate http://Alice" when the container starts, creating a wallet for the Alice node.
Option B: Standard Setup
docker run -d --name Alice --network eiou-network eioud Step 4a: Set Up Multiple Containers (Optional)
For testing with multiple users, you can set up additional containers:
Quickstart Setup (with auto-generated wallets):
docker run -d --name Bob --network eiou-network -e QUICKSTART=Bob eioud docker run -d --name Carol --network eiou-network -e QUICKSTART=Carol eioud docker run -d --name Daniel --network eiou-network -e QUICKSTART=Daniel eioud Show Standard Setup (manual wallet creation)
docker run -d --name Bob --network eiou-network eioud docker run -d --name Carol --network eiou-network eioud docker run -d --name Daniel --network eiou-network eioud Step 5: Verify the Container(s) are Running
docker ps This command will show all running containers. You should see your eIOU container(s) listed with their names (Alice, Bob, Carol, Daniel, etc.) and status.
Step 6: Check Container Logs
docker logs Alice If you have any questions or need assistance, please don't hesitate to contact us.
Quickstart Users
If you used the quickstart flag during setup, your wallet has already been generated automatically. You can skip this tutorial and proceed to the next section.
Skip to Next Tutorial →