The File Vault — Offline Resources

Every plugin version has a dedicated file vault for storing resources that get deployed to VMs during builds. This is how you get installers, scripts, configs, and binaries onto machines without relying on internet access.

Why Offline?

Web links break. Installers get pulled from vendor sites. CDNs go down. Your plugin should work reliably months or years from now, regardless of what happens on the internet.

Rogue Arena takes a two-pronged approach:

• Windows packages and custom files — store in your plugin’s vault and deploy via file-syncer
• Linux packages — handled automatically by the APT mirror, no vault needed for standard packages
• Everything else — scripts, configs, Docker images, archives — store in your vault

Uploading Files

In the plugin editor, open the File Vault tab. Upload files using the file browser — the platform uses TUS (resumable upload protocol) so large uploads can survive connection interruptions.

• Maximum file size: 4 GB per file
• Supported types: anything — .exe, .msi, .iso, .zip, .tar.gz, .deb, .ps1, .sh, .conf, .json, Docker exports, etc.
• Organization: create folders to keep your vault organized

Referencing Vault Files in YAML

Reference uploaded files with relative paths from your vault root:

- name: Copy installer to target machine
  ansible.windows.win_copy:
    src: "myapp-installer.exe"
    dest: 'C:\Temp\myapp-installer.exe'

- name: Install application
  ansible.windows.win_package:
    path: 'C:\Temp\myapp-installer.exe'
    arguments: '/S /quiet'
    state: present

The editor highlights missing file references in red with hover tooltips, so you’ll catch typos before building.

How Files Deploy

At build time, vault files transfer directly to the VM via internal high-speed transfer:

NFS storage → file-syncer → vsock → VM filesystem

This is a direct server-to-VM transfer over the hypervisor’s virtual socket — no internet connectivity needed on the VM, no HTTP downloads, no external dependencies.

Vault Quotas

Plugin vaults have configurable size limits. If you’re working with large files (ISOs, Docker images) and hit quota limits, your team admin can grant the rogueArchitectPluginUnlimitedStorage permission for your account.