Storage Gateway

Storage Gateway lets you:

• Connect your storage to one or more MASV Portals and have files automatically delivered to it.
• Use the MASV Admin Console with Team members to access specific file locations on connected storage without requiring direct or remote access.

Setup guide

For an end-to-end walkthrough, see How to integrate storage devices with MASV.

Prerequisites

Storage Gateway requires MASV Engine (formerly MASV Agent) to be installed on the server that provides storage. Choose one of the following installation methods:

• Native setup for Linux, macOS, or Windows.
• Docker setup.

Tip

If you’re running MASV Engine with Docker, run masv or curl commands inside the container. See the Docker setup guide for details.

---

Add a connection

CLI

# Store your gateway secret in an environment variable — never hardcode it.
# See /api/api-keys/ for key management best practices.
masv gateway add \
  --id "$GATEWAY_ID" \
  --secret "$GATEWAY_SECRET" \
  --name "$CONNECTION_NAME" \
  --root-path "$SHARED_FOLDER" \
  --permissions "$PERMISSIONS" \
  --uid <your-uid> \
  --gid <your-gid>

Name	Type	Required	Description
id	String	Yes	ID of the existing Storage Device Integration.
name	String	Yes	Connection name — use something descriptive and easy to recognize.
permissions	String	Yes	File permissions for this connection. Valid values: r, w.
root-path	String	Yes	This folder and everything within it becomes remotely accessible. Must be an absolute path.
secret	String	Yes	Unique secret key required to register this connection with the MASV API.
gid	Integer	No	Custom group ID override. Used to assign ownership of downloaded files on Linux. Not supported on Windows or read-only connections.
uid	Integer	No	Custom user ID override. Used to assign ownership of downloaded files on Linux. Not supported on Windows or read-only connections.

Tip

Linux native installations run the background system service as root. If you want downloaded files to belong to a specific user, specify gid and uid overrides.

REST API

curl -X POST -H "Content-Type: application/json" \
  http://localhost:8080/api/v1/storage_gateway/register -d '{
    "id": "$GATEWAY_ID",
    "secret": "$GATEWAY_SECRET",
    "name": "$CONNECTION_NAME",
    "root_path": "$SHARED_FOLDER",
    "permissions": "$PERMISSIONS",
    "user_id": <your_uid>,
    "group_id": <your_gid>
  }'

Name	Type	Required	Description
id	String	Yes	ID of the existing Storage Device Integration.
name	String	Yes	Connection name — use something descriptive and easy to recognize.
permissions	String	Yes	File permissions for this connection. Valid values: r, w.
root_path	String	Yes	This folder and everything within it becomes remotely accessible. Must be an absolute path.
secret	String	Yes	Unique secret key required to register this connection with the MASV API.
group_id	Integer	No	Custom group ID override. Used to assign ownership of downloaded files on Linux. Not supported on Windows or read-only connections.
user_id	Integer	No	Custom user ID override. Used to assign ownership of downloaded files on Linux. Not supported on Windows or read-only connections.

Tip

Linux native installations run the background system service as root. If you want downloaded files to belong to a specific user, specify group_id and user_id overrides.

---

List connections

CLI

masv gateway ls

REST API

curl -X GET http://localhost:8080/api/v1/storage_gateway/list

---

Remove a connection

CLI

masv gateway rm CONNECTION_ID

REST API

curl -X POST -H "Content-Type: application/json" \
  http://localhost:8080/api/v1/storage_gateway/unregister -d '{
    "id": "CONNECTION_ID"
  }'

Tip

Removing a connection disconnects it from MASV Engine — it does not delete the Storage Device Integration from your MASV account.

---

Update a connection

CLI

masv gateway update id \
  --root-path "$NEW_ROOT_PATH" \
  --uid <new-uid> \
  --gid <new-gid>

Name	Type	Required	Description
id	String	Yes	ID of the existing Storage Device Integration.
root-path	String	No	New root folder. Must be an absolute path.
gid	Integer	No	Custom group ID override. Provide -1 to remove the override.
uid	Integer	No	Custom user ID override. Provide -1 to remove the override.

REST API

curl -X POST -H "Content-Type: application/json" \
  http://localhost:8080/api/v1/storage_gateway/update -d '{
    "id": "$CONNECTION_ID",
    "root_path": "$NEW_ROOT_PATH",
    "user_id": <new-user-id>,
    "group_id": <new-group-id>
  }'

Name	Type	Required	Description
id	String	Yes	ID of the existing Storage Device Integration.
root_path	String	No	New root folder. Must be an absolute path.
group_id	Integer	No	Custom group ID override. Provide -1 to remove the override.
user_id	Integer	No	Custom user ID override. Provide -1 to remove the override.

---

Next steps

• Authentication — Authenticate with API keys or credentials.
• Uploads — Send files via team email, shareable link, or portal.
• Downloads — Initiate, monitor, and manage file downloads.
• Automations — Set up automated download and upload workflows.