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

  1. Install Docker on your system if you haven't already (troubleshoot installation issues)
  2. Download and load the eIOU Docker image
  3. Run the container with the appropriate configuration
  4. 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.

Next Steps

Once you have Docker set up, you can:

  • Run the eIOU protocol locally
  • Create your first wallet
  • Start making transactions

View the full documentation to learn more about using the eIOU protocol.

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 →