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
Linux
ip addr | grep -w inet
Mac
ifconfig | grep 192
A few addresses may show up in the list, choose the local address for your computer (normally 192.x.x.x)
MAC GUI
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 account setup page.
4 - Configure with MOTAR License
You will be brought to the account setup page to finalize your MOTAR Instance Setup.
1
Enter ALL fields shown.
2
Click the "Attach License" button and upload the license file you were given.
Enter a password. For simplicity sake, you may enter the password below as your password.
DO NOT use this password for any real or production instances.
Zebra$19plane!echo
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 Partners.
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 - Government User
Account Details
First Name:
James
Last Name:
Walker
Primary Email:
jim.walker@2usaf-demo.mil
Dropdown Selection - Salutation:
Mr.
Title
POC
Dropdown Selection - Gender:
Male
Dropdown Selection - Legal User Type:
US Government
Dropdown Selection - Designation of Person:
Military
User Role
Checkbox Selection - Role:
Auditor
Government Agency
Dropdown Selection - Government Agency:
DoD
Dropdown Selection - Branch:
Air Force
Designation Details
Dropdown Selection - Status:
Active
Primary AFSC#:
123456
MAJCOM:
ACC
Dropdown Selection - Military Grade:
O-3
Temporary Password:
Welcome12345!Test
User 2 - Government Contractor
Account Details
First Name:
Kalvin
Last Name:
Smith
Primary Email:
kalvin@awesomexr.com
Dropdown Selection - Salutation:
Mr.
Title
Manager
Dropdown Selection - Gender:
Male
Dropdown Selection - Legal User Type:
Contractor - US Government
Dropdown Selection - Company/Organization:
Awesome XR
User Role
Checkbox Selection - Role:
Standard
Government Agency
Dropdown Selection - Government Agency:
DoD
Dropdown Selection - Branch:
Air Force
Temporary Password:
Welcome12345!Test
User 3 - Government Contractor
Account Details
First Name:
Tiffani
Last Name:
Bee
Primary Email:
tiff@newhorizonxr.com
Dropdown Selection - Salutation:
Ms.
Title
Producer
Dropdown Selection - Gender:
Female
Dropdown Selection - Legal User Type:
Contractor - US Government
Dropdown Selection - Company/Organization:
New Horizon XR
User Role
Checkbox Selection - Role:
Standard
Government Agency
Dropdown Selection - Government Agency:
DoD
Dropdown Selection - Branch:
Air Force
Temporary Password:
Welcome12345!Test
User 4 - Government Civilian
Account Details
First Name:
Jenna
Last Name:
Garland
Primary Email:
jenna.garland@1nasa-demo.gov
Dropdown Selection - Salutation:
Dr.
Title
Lead Engineer
Dropdown Selection - Gender:
Female
Dropdown Selection - Legal User Type:
US Government
Dropdown Selection - Designation of Person:
Civilian
User Role
Checkbox Selection - Role:
Standard
Government Agency
Dropdown Selection - Government Agency:
US Gov Exec Branch/Agencies
Branch:
NASA
Temporary Password:
Welcome12345!Test
User 5 - Public (optional)
Account Details
First Name:
Adam
Last Name:
Coder
Primary Email:
adam@samplepublicuser.com
Dropdown Selection - Salutation:
Mr.
Title
Consultant
Dropdown Selection - Gender:
Male
Dropdown Selection - Legal User Type:
Public
Dropdown Selection - Citizen of:
United States
User Role
Checkbox Selection - Role:
Standard
Temporary Password:
Welcome12345!Test
User 6 - Government (optional)
Account Details
First Name:
Robert
Last Name:
Chen
Primary Email:
robert.chen@1army-demo.mil
Dropdown Selection - Salutation:
Mr.
Title
Engineer
Dropdown Selection - Gender:
Male
Dropdown Selection - Legal User Type:
Contractor - US Government
Dropdown Selection - Designation of Person:
Military
User Role
Checkbox Selection - Role:
Standard
Government Agency
Dropdown Selection - Government Agency:
DoD
Dropdown Selection - Branch:
Army
Designation Details
Dropdown Selection - Status:
Active
MOS:
12B
MAJCOM:
TRADOC
Dropdown Selection - 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 Blue 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 Publish at the top of the listing page to publish your listing.
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
Info
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?
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 Contractors. 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
Connecting an XR Headset to your Instance
COMING SOON!
Connecting your XR Headset to your local MOTAR instance is and advanced setup requiring updates to both your network router and your headset's network configuration.
This process may be different for every user can cannot be completly covered in an online guide.
For more control and reliability, it is recommended you install MOTAR using the Advanced Deployment Guide for cloud hosting and connect to your instance via a domain.
This would allow MOTAR 3D and App connections without network modifications.
Install MOTAR 3D to XR 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 Apps on a 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
**Only apps installed on the headset will show a "Launch" button in MOTAR 3D
OR
Launch directly from Hub on the web!
Log into your MOTAR Instance and go to the 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.
Attach the license file from
"I certify that none of the information I will be uploading is considered classified."
“I certify that the information above is correct and ready to share”
"I certify that none of the information I will be uploading is considered classified."
“I certify that the information above is correct and ready to share”
"I certify that none of the information I will be uploading is considered classified."
“I certify that the information above is correct and ready to share”
"I certify that none of the information I will be uploading is considered classified."
“I certify that the information above is correct and ready to share”
"I certify that none of the information I will be uploading is considered classified."
“I certify that the information above is correct and ready to share”
"I certify that none of the information I will be uploading is considered classified."
“I certify that the information above is correct and ready to share”
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:
