Building Mofacts using Docker Compose

Building MoFaCTS from Source

Last Updated: 2025-01-12 | For: Developers | Level: Advanced | Version: Meteor 3.3.2+

💡 New to installation? Check the Installation Guide to choose the right installation type.

---

📋 Overview

This guide covers building custom Docker images from the MoFaCTS source code. Use this if you've modified the code and need to create your own deployment images.

Source repository: https://github.com/memphis-iis/mofacts

Docker deployment files: https://github.com/memphis-iis/mofacts-docker

---

Prerequisites

Before you proceed, make sure you have the following installed on your system:

• Docker: Install Docker
• Docker Compose: Install Docker Compose

You must also have a docker hub account to share your container or deploy it remotely. Docker Hub Signup Link

Usage

Step 1: Enter the vagrant environment

• The vagrant environment installs all prerequisites.

vagrant up && vagrant ssh

Step 2: Navigate to ~/mofacts/mofacts/.deploy

• Using the following command, enter the deployment directory where the docker-compose file is located.

cd ~/mofacts/mofacts/.deploy

Step 3: (Remote Storage for Docker Hub Only): Login to Docker Hub and Edit Docker-Compose

• Login to your docker hub account.

docker login

• Edit the docker-compose YAML file to reflect your docker hub username by changing the image tags for mofacts-mini and mofacts-syllables to specify your account name.

image: jrustyhaner/mofacts-syllables

to

image: <your-docker-hub-username>/mofacts-syllables

Step 4: Build or Run MoFaCTs using Docker

• The docker compose file will build MoFaCTs using meteor build automatically.
• Run the following command to build for remote:

docker-compose build

• Run the following command to start the server locally:

docker-compose run

Step 5 (Remote Only): Upload to Docker Hub

docker-compose push

Please see the remote install procedures on how to deploy your custom version of MoFaCTs. You will have to edit the docker-compose.yaml files to point to your docker hub account.

---

📚 See Also

• Installation Guide - Choose the right installation type
• Local Install - Local development setup
• Remote Install - Production server deployment
• Admin Reference - Administrative features
• GitHub Repository - Source code and issues
• FAQ - Common questions and troubleshooting

---

Need Help? Check the FAQ or report issues on GitHub.