Installation

English | 日本語

Table of Contents

  1. Installer Download
    1. macOS
    2. Windows
    3. Linux (Ubuntu/Debian)
  2. How to Install Dependencies
    1. macOS
    2. Windows
  3. How to Update
  4. How to Uninstall
  5. Trouble Shooting

Installer Download

macOS

  1. Install Docker Desktop for Mac (see below).
  2. Install Monadic Chat.

Windows

  1. Install WSL2 (see below).
  2. Install Docker Desktop for Windows (see below).
  3. Install Monadic Chat.

Linux (Ubuntu/Debian)

  1. Install Docker Desktop for Linux (See Docker Desktop for Linux).
  2. Install Monadic Chat.

How to Install Dependencies

macOS

Install Docker Desktop

Next, install Docker Desktop, which is software for creating container-based virtual environments.

Choose on of the two different packages depending on your Mac’s CPU. You can check the type of CPU on the terminal with the following command:

$ sysctl -n machdep.cpu.brand_string

Download Docker Desktop from Install Docker Desktop on Mac, but for Intel, download Docker Desktop Installer.dmg, and for Apple Silicon, download Docker Desktop Installer Apple Silicon.dmg.

Double-click the downloaded dmg file. Then drag and drop the docker icon to the Applications folder to install it. Once the installation is complete, start Docker Desktop. When you start Docker Desktop first time, you will be asked to accept the service agreement (→ press accept), choose settings (→ use recommended settings), and allow privileged access to apply configuration (→ enter your Mac username and password).

Once everything has been set up, the Docker Desktop icon will appear in the task bar. After Docker Desktop has started, you may close the Docker Desktop Dashboard window if it is open.

Windows

Below, the method to install Monadic Chat on Windows 11 Home will be explained. The same method can be used for Windows 11 Pro and Windows 11 Education as well.

Install WSL2

First, install WSL2, which is a Linux environment for Windows.

Open PowerShell in the administrator mode. To do this, search PowerShell (Start -> Windows PowerShell) and select “Run as administrator”.

Then execute the following command (the first > represents the command line prompt):

> wsl --install

Then reboot your computer. After rebooting, WSL2 and its default Linux distribution Ubuntu will be installed. During this process, you will be asked to enter a username and password for the Linux environment. Enter any username and password you like. You will need to remember this username and password later.

Now you have completed the installation of WSL2. You can start the Linux environment by searching for “Ubuntu” in the Windows search box and open the Ubuntu terminal.

Install Docker Desktop

Next, install Docker Desktop, which is software for creating container-based virtual environments.

Download Docker Desktop from Install Docker Desktop on Windows.

Double-click the downloaded exe file. Once the installation is complete, start Docker Desktop. When you start Docker Desktop first time, you may be asked to accept the service agreement (→ press accept) and choose settings (→ use recommended settings).

Once everything has been set up, the Docker Desktop icon will appear in the task tray at the bottom right of the screen. After Docker Desktop has started, you may close the Docker Desktop Dashboard window if it is open.

How to Update

  1. Click Check for Updates in the menu. If an update is available, click Download to download the latest version.
  2. Quit Monadic Chat.
  3. Run the installer for the latest version.

How to Uninstall

  1. Click Uninstall Images and Containers in the menu. This will remove the Docker containers and images shown below.
  2. Quit Monadic Chat.
  3. For macOS, open the Applications folder in Finder and drag Monadic Chat to the trash. For Windows, uninstall Monadic Chat from Add or Remove Programs.

Trouble Shooting

In case of any trouble, updating or uninstalling Monadic Chat, remove the following Docker containers and images manually and try again.

Containers

Images