Cover photo

How to Set Up WSL, Install Podman & Run the Union Ceremony Node/Container

A Beginner’s Guide (Step-by-Step)

Share Dialog

Visit: https://ceremony.union.build/
Connect with Github/Google and then follow the on-screen process.

Next:

Step 1: Install WSL (Windows Subsystem for Linux)

First, we need to install Ubuntu on WSL (Windows Subsystem for Linux).

How to Install WSL:

  1. Open PowerShell as Administrator (Search for PowerShell, right-click, and select Run as Administrator).

  2. Run this command to install WSL with Ubuntu:

    wsl --install Ubuntu
  3. Restart your computer when asked.

  4. After restarting, open Ubuntu from the Start Menu.

Success Check: You should see a terminal asking you to create a username and password.


Step 2: Install Podman in WSL (Ubuntu)

Now, we will install Podman, which is an alternative to Docker.

Install Podman

  1. In your Ubuntu terminal, update your system:

    sudo apt update && sudo apt upgrade -y
  2. Install Podman:

    sudo apt install podman -y
  3. Verify Podman is installed:

    podman --version

    If you see a version number, Podman is installed correctly!


Step 3: Configure Podman to Work Like Docker (Optional)

Since most guides use Docker, we can make Podman respond to Docker commands.
Run this in Ubuntu:

sudo ln -s /usr/bin/podman /usr/bin/docker

Now you can use Docker commands, but they will actually run with Podman.


Step 4: Pull the Union Ceremony Container

Now, let's download the container image we need.

  1. Open Ubuntu and run:

    podman pull ghcr.io/unionlabs/union/mpc-client:v1.2

    This downloads the container image from GitHub Container Registry (GHCR).

  2. Check if the image was downloaded:

    You should see something like:

    REPOSITORY                               TAG   IMAGE ID   CREATED   SIZE  
    ghcr.io/unionlabs/union/mpc-client      v1.2  abc123xyz  2 days ago  500MB

Step 5: Run the Union Ceremony Container

Now that we have the container image, let's run it.

  1. Create a folder for the ceremony data:

    mkdir -p ~/ceremony
  2. Run the container:

    podman run -v ~/ceremony:/ceremony -w /ceremony -p 4919:4919 --rm -it ghcr.io/unionlabs/union/mpc-client:v1.2

    This starts the container and makes it ready to use.


Step 6: Verify the Container is Running

To check if the container is running, open another Ubuntu terminal and type:

If it’s running, you will see the container ID and details.


Congratulations! You Have Successfully Set Up & Run the Union Ceremony Container!

Now you can share this guide with other beginners who want to do the same! 😊