Local Deployment

Many developers prefer to deploy new software within their local environment to explore the new technology and kick the software tires around. Any License can be used for a Local deployment, while the Developer License is restricted to Local Deployments only. The License Keys enable developers to spin up and down instances of the Form.io platform locally on the developer's machine allowing for local development and testing without affecting the remotely deployed platform configuration.

Docker Compose Local Deployment

Form.io uses Docker Compose to define and run the containers necessary to locally install the Form.io Enterprise platform. Review the Prepare Your Environment section of the Self-Hosted Deployment guide to learn more about Docker Desktop before continuing with the Local Deployment walkthrough.

Download The Docker Compose File

Now that we have Docker Desktop running, navigate to the Form.io Deploy repo. Click the deployments/compose folder and download the local.zip file which holds the necessary files to install and run the Form.io containers. Locate the zip file on your Local Machine and unzip it into a folder.

Setting The License Key

Open the zipped folder within your preferred IDE, click the .env file, and locate the following line.

LICENSE_KEY=YOURLICENSE

Change YOURLICENSE to the Enterprise License key distributed to you by Form.io.

Installing Form.io Using Docker Compose

After saving the .env file, change your terminal directory to your deployment folder and run the following command.

docker-compose up --detach

This will start the Form.io platform containers and Mongo Database within your local machine.

Authenticating Into The Portal

After the installation process has been completed, navigate to the following URL to access the Local Deployment.

http://lvh.me

To authenticate into the platform, use the following credentials:

• [email protected]

• CHANGEME

Data Access Folder

All MongoDB data as well as PDF files are stored within the local data directory which is part of the deployment folder.

Additional Software and Technology

The next section will detail additional software you can install to facilitate things like File Storage and Container Management within your local environment.