This guide will walk you through the process of building a Moose application and deploying it to a server that does not have internet access. We'll cover both the build environment setup and the deployment environment requirements.
Before you can build a Moose application, you need to set up your build environment with the following dependencies:
OS:
Common CLI utilities:
Typescript build environment requirements:
First, ensure you have Node.js installed. We recommend using nvm (Node Version Manager):
# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# Reload shell configuration
source ~/.bashrc # or ~/.zshrc
# Install and use Node.js 20
nvm install 20
nvm use 20Verify the installation:
node --version
npm --version # or yarn --versionYou can install the Moose CLI using the official installer:
curl -SfsL https://fiveonefour.com/install.sh | bash -s -- moose
source ~/.bashrc # Or restart your terminalor
npm install -g @514labs/moose-cliThis step is optional if you already have a Moose project. Create a new Moose project:
moose init your-project-name ts
cd your-project-nameInstall dependencies:
npm install # or yarn installMake sure you have the zip utility installed (sudo apt install zip) before building your application.
If you installed the moose cli to be available globally, you can build the application with the following command:
moose buildOr if you installed the moose cli to be available locally, you can build the application with the following command:
Create the deployable package:
npm run moose-cli buildThis will create a zip file in your project directory with a timestamp, for example: your-project-name-YYYY-MM-DD.zip
The deployment server requires:
Follow the Node.js installation steps from the build environment setup section.
sudo apt install unzipCopy your built application package to the deployment server
Extract the application:
unzip your-project-name-YYYY-MM-DD.zip -d ./app
cd ./app/packager# If using npm scripts
npm run moose-cli prod
# Or directly with moose
moose prodEnsure all required environment variables and configurations are properly set before starting your application.
node --versionpackage.jsontsconfig.json is properly configurednode --versionpackage.jsontsconfig.json is properly configured