MOTAR Installer for Windows
This page will guide you through the process to install MOTAR Locally for testing and demonstration purposes.
Installing MOTAR
Download the latest MOTAR Local Installer here:
If your system does not have WSL installed or enabled, the MOTAR Installer will prompt you to install WSL before continuing. Read more about WSL WSL Not Installed
Running the installer requires Admin privleges on the computer used to run MOTAR.
If you did not run the installer as administrator, you will be prompted to do so once the installer starts.
Select YES
A few notes will display, before installation begins:
Press ENTER to begin the installation process.
The installer will check your system for requirements, install Docker and download all necessary MOTAR packages.
During installtion, the installer will pause with important messages and allow you time to act on those prompts.
Aborting a script with CTRL-C will only stop the active script from continuing and does NOT stop the full installation process. This may lead to an incomplete installation. Read all messages and prompts before aborting.
Once all checks are complete and required software installed, the latest MOTAR images will be downloaded and installed.
Once installation is complete, the following message will display and a web browser tab will open with your initial MOTAR setup page.
Congratulations!
Your MOTAR Instance is now ready to add test content!
If you are following the tutorial, you may continue where you left off:
Commercial: 4 - Configure with MOTAR License
Government: 4 - Configure with MOTAR License
Troubleshooting
A small guide of solutions to common errors you may encounter during installation.
WSL Not Installed
MOTAR requires Windows Subsystem for Linux (WSL) to be installed on the computer. You can learn about WSL from the official Microsoft site: https://learn.microsoft.com/en-us/windows/wsl/about
During the initial run, the installer will check your system for WSL, if not found, you will see the following message:
To install WSL (Windows Subsystem for Linux):
Open a new PowerShell window as ADMIN
Type:
wsl --install -d Ubuntu-24.04
Ubuntu WSL will install on your machine.
You will be prompted by the installer to create a username/password. The WSL installer will default to your Windows username. Make note of your username and password, you'll need this to remove MOTAR later!
If you are on Windows 10 you may be prompted for a reboot. If this happens, simply rerun the MOTAR Installer after reboot.
Once WSL is installed on your machine, rerun the MOTAR Installer for Windows.
Dependency Failed to Start: Container Minio is Unhealthy
You may receive the following error during installation, especially if you have installed MOTAR locally in the past and did not completely remove the instance.
ERROR: docker compose failed inside WSL. Ensure Docker is installed and the target WSL distro is running.
This error may be caused by the minio container being corrupt, shown in the installation status as "dependency failed to start: container minio is unhealthy".
To resolve this issue
Open a Powershell window as Admin and start WSL by entering:
wslNavigate to the install folder by entering:
cd "<your path to the MOTAR install>"
Example: "C:\Users\dynepic\MOTAR\motar-3.1.5-docker-compose"You may be prompted to enter your username/password created during intial WSL install.
Your command line should now show
<username>@<computername>:/mnt/<path>Now, stop all instances of MOTAR by entering
docker compose down -v
//If you get a permission error, enter
sudo docker compose down -vYou should see all services shutting down
Close the Powershell window and rerun the MOTAR Installer for Windows (as administrator)
Uninstalling MOTAR
Manual Removal
So you have tested MOTAR and are ready to clean your local computer up. Follow this guide to remove MOTAR from your system.
Did you use your own content to populate MOTAR and are moving to a fully deployed production version? Before you remove MOTAR, follow this guide to backup your data and import into the new instance!
MOTAR currently does not include an automatic uninstaller. To fully remove MOTAR and its related components after local testing, follow these steps:
Stop and remove running containers
First, make sure all MOTAR containers are stopped and removed.
Open a Powershell window as Admin and start WSL:
wsl -d Ubuntu-<version#> //example: wsl -d Ubuntu-24.04You may be required to enter the WSL password created during installation.
Navigate to the MOTAR installation directory using the CD command:
cd /mnt/c/users/<username>/motar/motar-<version>-docker-compose/motar-<version>-docker-compose/easysetupFrom the MOTAR installation directory, run:
docker compose down -vThis removes all unused images, containers, and volumes on your system, not just MOTAR. If you want to only remove MOTAR containers and images, use:
Remove local Docker images and volumes
docker system prune -a --volumesIf you want to only remove MOTAR containers and images, use:
docker images //list all images docker image rm <image id>Do this for each image you want to remove.
Delete MOTAR Installation Folder
While still in Powershell WSL type:
rm -rf /mnt/c/Users/<your-username>/MOTARClose Powershell
MOTAR has now been removed from your system.
Last updated