Before updating MOTAR, you should take a backup of your instance. See: Backup & Restore Data
The Platform Version tab has a version checker, will tell you when there is a new version available to update:
When a new version is available, (!) will show next to the Platform Version tab.
Note the Installed Version vs Available Version in the image below.
Updating your MOTAR Ghost to the latest version is highly dependent on your installation method. Choose the method below that matches your installation. If you do not know what type of installation you have, consult your platform admin.
WARNING
Updating the platform version requires some degree of technical knowledge pertaining to your company's server architecture and installation method.
Please review the steps below and if you are unsure of any of the steps, DO NOT PROCEED, reach out to your company administrator or Contact Us!
Choose the guide based on your installation method:
HELM Installation
Upgrade
WARNING
If you did not provide secrets for HELM install, do NOTdelete the secrets . The update process will recreate secrets and motar won't be able to access your data.
To update the MOTAR version on your HELM install, run:
If you uninstall instead of upgrade, you need to backup your secrets and your instance first!
Backup your secrets file (secrets backup is not covered in this guide. If you need assistance on how to backup your secrets, refer to your IT administrator.
The relevant secrets will persist (do not delete the ones that stayed)
If secrets were deleted you will need to destroy persistent volumes
If you uninstall MOTAR before updating, you will need to restore from backup.
Follow this guide to restore your data: Backup & Restore Data
ARGO Installation
Update the MOTAR version number to in your settings to the latest version number listed in your Platform Verision tab.
See example below.
DOCKER Installation
Installing via Docker
If you want to shut down your instance during the update run:
docker compose down
Take note of where you download the MOTAR installation package because you will need it to configure the MOTAR Environment.
cd /path/to/motar/download/directory/motar-3.0.1-beta-docker-compose/EasySetup
Check and Configure Docker
Before running Docker commands, ensure the Docker desktop app is running.
Open your terminal window
Search Terminal in Spolight or find it in Application > Utilities
Run the following command to check if Docker Compose is installed:
docker compose version
You should see a result like this example (your result may vary):
Docker Compose version v2.31.0-desktop.2
If no errors, continue, otherwise if you encounter a permission error, prepend sudo to the command:
sudo docker compose version
Make sure your Docker is running by typing:
docker ps
As an example, if docker is running, but there are no containers running you may see output like this (if you have containers running you may see additional details beneath these headings):
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
If you get the proper response, continue to Updating MOTAR Installation, otherwise if you encounter a permission error, use the sudo command:
sudo docker ps
If you still encounter an error or do not see the expected output (see below), please follow Docker’s documentation for fixing your Docker or Docker Compose.
With Docker running it is time to Configure your MOTAR Environment
Configure Your MOTAR Environment
While in Terminal, you will configure your MOTAR Docker package.
Change directory to the location you saved the MOTAR docker compose install package from Updating MOTAR Installation
This is the folder where you saved your motar--docker-compose.tar.gz file.
cd /<path to motar-docker-compose package> # Change to your MOTAR download directory
# Example: cd /downloads/
Unpack the MOTAR installation file (if you already unpacked the file, you may skip to step 3)
tar -xvf motar--beta-docker-compose.tar.gz
Once the file is unpacked, you will need to change directory into the EasySetup folder.
cd motar--beta-docker-compose/EasySetup
For other more advanced options, replace the child sub-directory with ‘SelfProxy-Advanced’ or ‘EasyDNS’. This walk-through will only provide instructions for ‘EasySetup’.
Before launching MOTAR, you'll need to copy sample environment files and update with your deployment’s specifics. Sample environment files are provided to help you get started.
cd /path/to/motar/download/directory/motar-3.0.1-beta-docker-compose/EasySetup
cp ../sample_env .env
cp ../sample_motar_env motar.env
For this demo the URL for your MOTAR intance will be set to "motarghost.com".
MOTAR images are hosted in Dynepic’s private Harbor repository. Follow these steps to authenticate
Deploying MOTAR with Docker Compose
MOTAR can be deployed in different configurations. Choose the setup that best suits your needs.
Ensure you are still in the EasySetup folder in Terminal
cd motar-X.X.X/EasySetup #Your installation directory
docker compose up -d # brings up the deployment in the background
Deployment of MOTAR on your local machine will take 3-5 minutes.
You should see the following progress/message(s)
✔[+] Running 19/19
✔ Network motar_motar Created
✔ Container minio Healthy
✔ Container motar-traefik-1 Started
✔ Container nats Started
✔ Container dnsmasq Started
✔ Container postgres Healthy
✔ Container clamav Started
✔ Container db-init Exited
✔ Container obj_init Exited
✔ Container assets Healthy
✔ Container scanner Started
✔ Container devices Started
✔ Container hub Started
✔ Container admin Started
✔ Container studio Started
✔ Container login Started
✔ Container studio-permissions Started
✔ Container hub-permissions Started
✔ Container devices-permissions Started
Launching a browser window may direct your admin page to https://
to avoid this, launch in a private window. This should keep the path http://
Configuring Network & Domain Routing
To ensure your client device can resolve domain names correctly, configure your DNS settings.
Use the following Terminal command to backup your 'hosts' file:
cp /etc/hosts /etc/hosts_bak
Append your 'hosts' file with the following command:
IP="127.0.0.1"
BASE_URL="motarghost.com"
echo "$IP admin.$BASE_URL hub.$BASE_URL studio.$BASE_URL devices.$BASE_URL api-minio.$BASE_URL login.$BASE_URL console-minio.$BASE_URL minio" | sudo tee -a /etc/hosts
The following guide is for Docker installtion/update on a Linux/Mac machine. For Windows machines, see the Tutorial setup installation guide:
the correct install package for your operating system.
If you do not have access to this link, please reach out to for assistance.
