A "Government" configured MOTAR license enables assets to be marked with government data markings (distribution statements, data rights, etc.).
MOTAR then provides Zero Trust at the asset level because each asset is digitally tagged with government data markings and users are assigned appropriate legal identities such as US military, US government, US contractor, foreign partner, etc.
This government ICAM is unique to MOTAR (U.S. Patent No. 12,204,684 and others pending).
Administrator access is required to install MOTAR on your device.
This guide covers installation on a local computer (desktop, laptop, Raspberry Pi).
🎯 What to Expect
This tutorial will walk you through:
System Requirements and Tutorial Files
Installation Steps (Docker or Helm)
First-time Setup and Login
Adding User, Studios, and Assets
✅ MOTAR Hardware Specifications
Hardware Specifications
MOTAR is lightweight and highly portable; it can run on hardware ranging from a Raspberry Pi to a full cloud-based cluster. The core system has a minimal footprint, but performance will depend on:
Number of concurrent users
Asset storage needs (models, images, audio)
Bandwidth and RAM availability
Choose the appropriate setup based on your use case:
Portable / Development (Minimum Viable)
Example: Raspberry Pi 5
CPU: 2.4GHz ARM 64-bit quad-core
RAM: 8–16GB DDR4
Storage: 128–250GB SSD (external preferred)
Network: Gigabit Ethernet or strong WiFi
✅ Good for: portable, single-user instances.
Desktop / Local Server (Recommended)
Suitable for small teams or internal use
CPU: AMD/Intel 64-bit, 4–8 cores
RAM: 16–32GB
Storage: 250GB+ SSD
Network: Wired Ethernet or reliable WiFi
✅ Balanced setup for moderate asset use and 1–10 concurrent users.
Cloud / Production (Scalable Infrastructure)
For high concurrency and asset-heavy environments
CPU: 16+ core AMD/Intel/ARM (x86_64)
RAM: 64GB+ (scale based on users)
Storage: 1TB+ SSD or expandable volume
Network: High-throughput, low-latency
✅ Supports Kubernetes with autoscaling nodes for dynamic performance under load.
💡 Tip: While MOTAR itself is lightweight, your assets and users will dictate the scale. Plan ahead for growth in RAM, storage, and bandwidth.
Throughout this tutorial, we will refer to the latest version number .
The current version may have changed and will need to be replaced. Your MOTAR installation package will have the most up-to-date version number listed.
If you do not have access to these assets, Contact Us! for assistance.
MOTAR with Ghost activation currently has two installation methods:
Already have Docker installed? Skip to "Check and Configure Docker"
Recommended for local installation for demo or testing purposes only!
This demo is not intended for production usage and does not feature robust security.
Install Docker Compose
This local installation method is intended for trial use and is the most simple way to evaluate MOTAR.
The Docker Compose option is best for those seeking to quickly install and evaluate MOTAR on your machine for testing and demonstration purposes. (i.e., for Local, non-production, single node, low availability deployments).
INSTALL Docker Compose to your machine.
Ensure you save all open documents/files on your computer before installing Docker Compose as your computer may be restarted.
2
Check and Configure Docker
Linux / Mac / Raspberry Pi
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 #linux-mac-1, 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
Windows
All commands must be entered in an administrative Powershell window!
Before running Docker commands, ensure the Docker desktop app is running.
Open PowerShell
Type PowerShell in the search bar and right click.
Select "Run as administrator"
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
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 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"
3
Configure Your MOTAR Environment
Linux / Mac / Raspberry Pi
For other more advanced options, replace the child sub-directory with ‘SelfProxy-Advanced’ or ‘EasyDNS’. This walk-through will only provide instructions for ‘EasySetup’.
While in Terminal, you will configure your MOTAR Docker package.
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.
Change the working directory to the EasySetup folder in the downloaded MOTAR-main files:
cd /path/to/motar/download/directory/
#For Example: cd C:\MOTAR_Tutorial\motar-3.0.2-docker-compose\EasySetup
Then enter the command:
cp ../sample_env .env
Then enter:
cp ../sample_motar_env motar.env
This will make copies of the files, rename them, and place them inside the EasySetup folder.
Next, add your local IP to the newly create .env file.
Locate your Local IPv4 IP address by entering this command in Powershell
ip addr | grep -w inet
A few addresses may show up in the list, choose the local address for your computer (normally 192.x.x.x)
MAC Alternatively you can go to
About This Mac > More Info > Network > Wi-Fi (open) > Details
Next you need to add the IP to the *.env file.
Locate the NEW .env file in your EasySetup directory (Windows images shown)
Right click on the file and choose "Edit with TextEdit" (or your system text editor).
(Windows images shown)
Copy & Paste your local IP address into the field "HOST_IP"
Save the file & return to Terminal
Proceed to "Deploying MOTAR with Docker Compose"
Windows
This walk-through will only provide instructions for ‘EasySetup’.
For other more advanced options see Advanced Deployment Guide
While in PowerShell, you will configure your MOTAR Docker package.
Before launching MOTAR, you'll need to copy the sample environment file and update with your deployment’s specifics. Sample environment files are provided to help you get started.
Change the working directory to the EasySetup folder in the downloaded MOTAR-main files by entering:
cd /path/to/motar/download/directory/
#For Example: cd C:\MOTAR_Tutorial\motar-3.0.2-docker-compose\EasySetup
Then enter the command:
cp ../sample_env .env
Then enter:
cp ../sample_motar_env motar.env
This will make copies of the files, rename them, and place them inside the EasySetup folder.
Next, add your local IP to the newly create .env file.
Locate your Local IPv4 IP address by entering this command in Powershell
Error response from daemon: Ports are not available: exposing port UDP {HOST_IP}:53 -> 0.0.0.0:0: command failed
Run:
Mac
sed -i '' 's/"kernelForUDP": true,/"kernelForUDP": false,/' ~/Library/Group\ Containers/group.com.docker/settings.json
#Restart Docker Desktop
docker compose down
docker compose up -d
Windows
Ensure that you do not have any containers or services running on the port that fails to bind:
netstat -ano | findstr :{portnumber}
If possible, stop any containers or services using the port
docker compose down
Then rebuild
docker compose up -d
Linux
Ensure that you do not have any containers or services running on the port that fails to bind:
netstat -ano | findstr :{portnumber}
If possible, stop any containers or services using the port
docker compose down
Then rebuild
docker compose up -
What if Docker Daemon is Not Running?
Mac
Run dockerd
Linux
sudo systemctl start docker
Windows
Open Docker Desktop
What if I Get a Permission Error?
Use "sudo" before all Docker commands
Linux
sudo docker ps
OR add your user to the Docker Group
Linux
sudo usermod -aG docker $USER
Windows
Ensure you are running PowerShell as an administrator.
Stopping and Deleting Data
To completely remove all data associated with your deployment, after doing docker compose down, run:
docker container prune
docker volume prune
docker volume ls # To list the volumes
docker volume rm {volume_name}
#ex.
# docker volume rm motar_postgres_data
# docker volume rm motar_minio_data
If you didn't receive any errors, you are now ready to Access your MOTAR Instance!
3 - Access your MOTAR Instance
1
Complete Account Setup
Finish setting up your MOTAR Instance by using your web browser to go to the following website:
You will be redirected to the login page.
2
Login
The username field will auto populate with your firstname-lastname.
You will be asked to change your password after first login. The new password will require the same parameters. Please record this new password for future reference.
For first time login, enter any password that meets the following parameters:
Minimum of 15 characters
1 Upper Case Letter
1 Lower Case Letter
1 Numeric Character
1 Special Character
4 - Configure with MOTAR License
After logging-in you will be brought to the below page to finalize your MOTAR Instance Setup.
1
Enter all required (*) fields
2
Click the "Attach License" button and upload the license file you were given.
3
Click on the blue ‘Create Account’ button.
This created the admin account for you to gain access to this instance. You should now be logged in to the Admin service seeing the Platform Owner page.
Warning: You cannot login as multiple users in a single browser session.
If you would like to manage multiple users while testing MOTAR, you can open a new "incognito" tab and login as the second user or use a different browser for the second user.
5 - Add Platform Owner and Platform Branding
1
Click the blue Edit button to add the Owning company details
Let’s now add the Owning company details and platform branding materials using the tabs on the Owning Company menu page.
Cosmic Horizon is the owning company name for this tutorial and most of this information will already be completed based on the license that you uploaded. The Company Image and Favicon for Cosmic Horizon can be found at
MOTAR-Tutorial Files/Platform-Branding/Company-Icon
Some information will be auto-populated from the License. Your information will vary, depending on your license.
Fill in any other missing information for the Platform Owner page and click "Save"
2
Click on the Platform Branding tab
Fill out the Fields.
For this tutorial, please use the following:
If you are not conducting a trial of MOTAR, and are setting up a MOTAR Instance for your own use, you will input your company's information and upload your company's branding.
Platform Branding Details
If you are setting up a MOTAR Instance for your organization, you may input the information for those specific Partners.
6 - Create Contractor Companies - Studio Groups and Users
1
Create Contractor Companies
A contractor is an external organization that is allowed on your platform, they can access content that has been shared with them.
Navigate to the Contractors tab located on the left navigation menu
Click "+ Contractor"
The Contractor Details pop-up will open
Enter Contractor Details
In this tutorial, we will create two contractors, Awesome XR and New Horizon XR. These contractors will be tasked with creating 3D models and immersive application development.
Enter each contractor into the details pop-up
Click "Add" button to save the new Contractor
Expand the following section for Tutorial Contractor details.
Contractor Details
If you are setting up a MOTAR Instance for your organization, you may input the information for those specific Contractors.
Once you have enter both Tutorial Contractors, your Active Contractors screen should match the following image:
2
Create Studio Groups
A Studio Group functions like a department within a commercial organization. Users assigned to a Studio group are granted the "creator" role, giving them access to the Studio service.
Additionally, listings can be permissioned to specific Studio Groups, ensuring that only members of the appropriate group can access or manage them.
Navigate to the Studio Groups tab located on the left navigation menu
Click "+ Studio Group"
The Studio Group Details pop-up will open
Enter Studio Group details:
In this tutorial, you will create two Studio Groups: Awesome XR Studio and New Horizon XR Studio. These represent the functional studios for each partner, and individual users will be assigned to them accordingly.
Enter each Studio Group into the details pop-up
Click "Add" button to save the new Studio Group
Although the Studio Groups created in this tutorial may appear identical to the Partners added in the previous step, it's important to understand that a single Partner can have multiple Studio Groups, similar to departments within a company. For example, Awesome XR might include both an Production Studio Group and an Distribution Studio Group. This structure allows for highly customizable permission settings across different teams or functions.
Expand the following section for Studio Group details.
Studio Group Details
If you are setting up a MOTAR Instance for your organization, input the information for those specific Studio Groups.
Once you have enter both Tutorial Studio Groups, your Active Studio Groups screen should match the following image:
3
Create Users
Navigate to the Users tab located on the left navigation menu
Click "+ Add New User"
The User Details pop-up will open
The pop-up contains six sections that must be completed in order. You must fill out all required fields in the current section before proceeding to the next. Use the tabs below to view each section:
MOTAR offers multiple user roles:
Standard User: This role provides access to the platform features allowed by your license. It is selected by default. Standard users can interact with content according to the permissions set by the license.
Auditor: Auditors have expanded access. In addition to standard features, they can view, download, use, and distribute Hub listings. This role is ideal for users who need to audit or evaluate assets.
Admin: Admins have full access to the platform, including all administrative tools and settings.
In this tutorial, you created an admin user during the initial installation setup.
During this tutorial, we will switch between multiple user accounts. Each user must be assigned a password during creation, and they will be required to set a new password upon their first login.
For convenience, we’ve provided a temporary password and a final password that can be used across all tutorial users. These are intended for instructional use only, do not use them for any real or secure accounts.
For this tutorial, add the following four users via the users tab from the left menu, assign them to their respective Partner Companies and provision their respective roles.
We have also included a couple of additional users if you want to experiment with roles and permissions.
User Details
All other required information (Salutation, etc.) can be arbitrary for this tutorial.
For convenience, use the following shared passwords for all tutorial users:
Temporary Password (used when creating the user profile):
Welcome12345!Test
Final Password (used when logging in for the first time, required):
Zebra$19plane!echo
Important: These passwords are for instructional use only. Do not use them for securing real accounts.
User handles are auto-generated during user creation. For this tutorial, each user will have firstname-lastname user handles. These will be noted during later steps.
User 1 - Gov
Account Details
First Name
James
Last Name
Walker
Primary Email
jim.walker@2usaf-demo.mil
Salutation: Mr.
Title
POC
Gender: Male
Legal User Type: US Government
Designation of Person: Military
User Role
Role: Auditor
Government Agency
Government Agency: DoD
Branch: Air Force
Designation Details
Status: Active
Primary AFSC#
123456
MAJCOM
ACC
Military Grade: O-3
Temporary Password:
Welcome12345!Test
User 2 - Contractor
Account Details
First Name
Kalvin
Last Name
Smith
Primary Email
kalvin@awesomexr.com
Company/Organization:
Awesome XR
Title
Manager
Gender: N/A
Legal User Type: Contractor - US Government
Citizen of: United States
User Role
Role: Admin
Government Agency
Government Agency: DoD
Branch: Air Force
Temporary Password:
Welcome12345!Test
User 3 - Contractor
Account Details
First Name
Tiffani
Last Name
Bee
Primary Email
tiff@newhorizonxr.com
Partner Company
New Horizon XR
Title
Producer
Gender: N/A
Legal User Type: Contractor - US Government
Citizen of: United States
User Role
Role: Admin
Government Agency
Government Agency: DoD
Branch: Air Force
Temporary Password:
Welcome12345!Test
User 4 - Gov
Account Details
First Name
Karen
Last Name
Lopez
Primary Email
karen.lopez@1usaf-demo.mil
Salutation: Ms.
Title
Team Lead
Gender: Female
Legal User Type: US Government
Designation of Person: Civilian
User Role
Role: Standard
Government Agency
Government Agency: DoD
Branch: Air Force
Designation Details
Civilian Grade: A3
Band: 4
Job Series#
654321
Temporary Password:
Welcome12345!Test
User 5 - Contractor (optional)
Account Details
First Name
Adam
Last Name
Coder
Primary Email
adam@newhorizonxr.com
Partner Company
New Horizon XR
Title
Developer
Gender: N/A
Legal User Type: Contractor - US Government
Citizen of: United States
User Role
Role: Auditor
Government Agency
Government Agency: DoD
Branch: Air Force
Temporary Password:
Welcome12345!Test
User 6 - Gov (optional)
Account Details
First Name
Robert
Last Name
Chen
Primary Email
robert.chen@afrl-demo.mil
Salutation: Mr.
Title
Engineer
Gender: Male
Legal User Type: US Government
Designation of Person: Military
User Role
Role: Auditor
Government Agency
Government Agency: DoD
Branch: Air Force
Designation Details
Status: Active
Primary AFSC#
234567
MAJCOM
AFRL
Military Grade: O-2
Temporary Password:
Welcome12345!Test
Once you have enter all four Tutorial Users, your Active Users screen should match the following image:
4
Add Users to Studio Groups
Now we want to add those users into their respective studio groups.
Click on Studio Groups left menu
Click the Edit pencil and open New Horizons XR Studio group page
Click on the Users tab
Click the "+ User" button
Add Tiffani to this studio group by clicking the "+ Add" button next to their profiles
Click "Done"
Repeat these steps for the Awesome XR Studio
Add Kalvin to Awesome XR
5
Logout
Logout of the platform as the Owning Company Admin by clicking the navigator menu > "Logout"
Now that you have Partners, Studio Groups, and Users, you are ready to add content!
7 - Add Content to MOTAR Instance
As mentioned in the Introduction video, you are working with external partners who are aiding your corporation with 3D models and immersive application development.
This content needs to be added to the MOTAR platform, so that all company and partner users can access the content to achieve the contract's objectives.
In this next step, you will first add the MOTAR Tutorial Video that you watched at the start of this tutorial to the MOTAR Instance, so that it can be referenced by company and partner users throughout the contract.
Following that, you will add various 3D models that have been created by the Awesome XR Partner Organization, that will be used to create the application training users how to fly a UFO.
Login as Kalvin Smith of the AwesomeXR
Since this will be your first time logging in as this user, you will be required to change the password. Here are the logins:
Username:
kalvin-smith
Temporary Password (used when creating the user profile):
Welcome12345!Test
Final Password (used when logging in for the first time, required):
Zebra$19plane!echo
Navigate to the Studio service
The following steps may require you to log in and out of various users.
You cannot login as multiple users in a single browser session!
If you would like to manage multiple users while testing MOTAR, you can open a new "incognito" tab and login as the second user or use a different browser for the second user.
A Power Cell found near the crashed UFO found in the Outer Banks of North Carolina. This is believed to be the energy source of the UFO. Observations note that this Power Cell glows blue.
Found near the crash site, this Power Cell is believed to be the energy source for the crashed UFO found in the Tahoe National Forest. Dissimilar to the original Power Cell, this Power Cell glows Yellow.
Click the plus icon in the Partners Modify section
Add Cosmic Horizon and their partners to grant exclusive rights to this listing
Check the box:
“I certify that the information above is correct and ready to share”
Click Publish
When prompted, select Keep Current Permissions
Now that you have several listings on Hub, we will log out of the current user.
Log out of Kalvin Smith
Create an App Listing
The assets you uploaded to MOTAR in the previous step have been leveraged by the New Horizon XR Team to create an XR application teaching a user how to Fly the UFOs that have been found across the world.
This application needs to be uploaded to MOTAR, so that it can be securely distributed to members of the company that will fly the UFOs back to the laboratory for further research and analysis.
Log in as Tiffani Bee of New Horizon XR
Since this will be your first time logging in as this user, you will be required to change the password. Here are the logins:
Username:
tiffani-bee
Temporary Password (used when creating the user profile):
Welcome12345!Test
Final Password (used when logging in for the first time, required):
Zebra$19plane!echo
App Listing Guide
From the Studio service, click create on the App icon
Select "New Hub Listing"
Enter the required fields (listed below)
Once the required fields have been entered, the "Create" button will enable
Click "Create"
Your listing will now be created and the Info tab will automatically open.
Enter the following details and download the listed files for this listing:
App Listing Details
Listing Name
Learn to Fly UFO
Listing Description
An alien ship has crashed in a barn. Can you find all the power cells and fly away?
Click on the plus in the "Cosmic Horizon Modify" section to only give members of Cosmic Horizon rights to this listing
Check the “I certify that the information above is correct and ready to share” box
Click "Submit App for Review"
Now that the app as been created, we will go to Admin and approve the app. For this tutorial, we will stay logged in as Tiffani. In a normal workflow, app creation and approval would not be the same person.
Approve the App
Use the TopNav menu on the far left to navigate to the Admin service
From the left menu, navigate to App Review
Locate the app created in the previous step
Check the “I have reviewed the app….” box and approve the app
Use the TopNav menu on the far left to navigate to the Studio service
From the studio group service, find your app and click the Edit pencil, then click on "Publish"
Keep Current Permissions Settings
Navigate to the Hub service and see app in Production
Log out
Congratulations!
You've successfully learned how to add listings to your instance, approve apps, and create Users, Studio Groups, and Partners. You've covered all the foundational steps needed to manage your MOTAR environment.
The next section moves into more intermediate-to-advanced territory: setting up VR headsets and installing applications on them using our companion app. If you don't have access to a VR headset or prefer to pause here, feel free to continue exploring your MOTAR instance by logging in as different users and experimenting with what you've built so far.
Optional Steps
Install MOTAR 3D to VR Headsets
MOTAR 3D is an immersive XR companion application that allows you to quickly discover, install, and launch immersive content found on the Hub and begin collaborative learning through a virtual environment on any XR device, no matter where your team members are located.
MOTAR 3D is compatible with the following devices.
Meta Quest 2
Meta Quest 3
Meta Quest Pro
Vive Focus 3
It even works seamlessly with Meta Quest for Business.
Side loading applications to Meta Quest devices requires a Meta Developer account and for the device to be in "Devleoper Mode".
Install the App to the Headset
Your pre-existing app is now ready for distribution. Loading apps onto a VR device depends on your current organization setup.
Launch an Application
You can launch your application in two ways.
From within MOTAR 3D, by clicking "Launch" on the app listing
OR
Launch directly from Hub!
Log into Hub.
Locate the application and open the Hub listing Page.
Click “Launch with MOTAR 3D” in the top right corner.
If MOTAR 3D is installed on the Headset, click “Continue on Headset.”
Follow the instructions on the MOTAR Devices page to sync the headset.
Launch MOTAR 3D.
Sync the device.
Launcing applications via web or MOTAR 3D on Meta Quest devices requires the application be installed prior to launching.
Build an XR Application Using the MOTAR SDK for Unity
Ready to put your development skills to the test? Dive into our complete Unity XR sample project and see how easy it is to create immersive experiences using the MOTAR SDK for Unity. In this guide, you'll learn how to:
Set up the MOTAR SDK in a Unity project
Integrate the MOTAR XR Rig into your scene
Compile and prepare your application for hosting on your MOTAR instance
Whether you're exploring XR for the first time or looking to extend your MOTAR experience, this project is a great place to start!
Note: For details about supported features, platforms, and changes, please refer to the .
If you're deploying MOTAR to a server or cloud environment, see the .
apply.
For production environments, we recommend following the best security and disaster recovery practices for your situation with a customizable .
See for installation steps.
If you didn't receive any errors, you are now ready to
Attach the license file from
Instructions for downloading and installing MOTAR 3D can be found
Whether your ogranization uses Meta Quest for Business, Meta Quest Devloper Hub, or sideloading, learn how by following the app installtion guide:
