Local File Storage
Last updated
Was this helpful?
Last updated
Was this helpful?
When locally deploying the Form.io Platform, is the preferred method for local file storage. MinIO is an open-source distributed object storage server written in Go, designed for Private Cloud infrastructure providing AWS S3 storage functionality. This server is best suited for storing unstructured data and files such as photos and videos within the local environment.
MinIO can be used on an Enterprise level, however many customers opt to use storage provided by an existing component of their technology stack, or other storage methods when deploying to the Cloud or their own On-Premise environment.
To deploy a new MinIO server, complete the following pre-requisite steps:
Install either on the local machine, or on a private cloud server.
Create the necessary directories to store files using the file browser, or by executing the following commands:
Run the following command to pull the MinIO container from Docker Hub:
Execute the following command to start the MinIO container:
When a more secure deployment is required, exclude the environment variables for MINIO_ROOT_USER and MINIO_ROOT_PASSWORD as follows:
These keys can later be determined by running the Docker command:
Make sure to take note of these keys for later configurations.
Note that the sample credentials "CHANGEME" should be updated to reflect the credentials intended for access to the file storage.
In this example, note that MinIO is mounting the folder ~/minio. This can be changed to any drive on the system machine where MinIO should store files.
Verify the formio-minio container is running by executing the following command:
The result should look similar to the following:
Modify the hosts file to allow easy access to MinIO:
On MacOS/Linux: From the terminal run the following command, logging in if prompted:
On Windows: Use Notepad as an Administrator to open the file C:\Windows\System32\Drivers\etc\hosts
Once the file is open, modify the appropriate line to read:
After successfully loading the MinIO dashboard, navigate to Buckets under the Administrator tools on the left-hand menu.
Create a new Bucket by clicking on the Create Bucket+ button. Give the bucket a descriptive name and record the choice for future configurations.
The MinIO Server should now be operational.
In a browser, navigate to ( or http://localhost:9001) to view the MinIO interface. Log in using the MINIO_ROOT_USER and MINIO_ROOT_PASSWORD previously used to start the container.
