Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/WyattBrashear/507ex-utils2/llms.txt

Use this file to discover all available pages before exploring further.

The upload command reads the unique exec_id from a .507ex file’s metadata header, prompts you for a CAR server address, and POSTs the file to the server’s /push endpoint. The server responds with a download URL and a secret code. You share the URL and code with anyone who needs to run the executable — they pass both to fzx2 exec.

​
Usage

fzx2 upload <path>
​
path
string
required
Path to a local .507ex file built with fzx2 build. The file must exist and contain a valid 507ex-id metadata field.

​
How it works

1

Validate the file path

fzx2 checks that the file exists. If it does not, the command exits immediately with File not found!.
2

Read the exec_id from the metadata header

The file is scanned line by line until a line beginning with 507ex-id| is found. The UUID following the pipe character is used as the file_id sent to the server.
3

Prompt for the server address

Please enter the server address:
Enter the full base URL of your CAR server, for example http://192.168.1.50:5000.
4

POST to /push

The .507ex file is sent as a multipart upload to <server>/push with the file_id field included in the form data.
5

Display the result

On success, the server returns JSON containing the download URL and a secret code. Both are printed to your terminal.

​
Example terminal session

$ fzx2 upload my_app.507ex
Please enter the server address:
http://192.168.1.50:5000
Upload Complete!
Upload URL: http://192.168.1.50:5000/pull/a1b2c3d4-e5f6-7890-abcd-ef1234567890
Your Secret Code Is: 482910

​
Server response format

The /push endpoint must return a JSON object with at least the following fields: 
{
  "url": "http://192.168.1.50:5000/pull/<file_id>",
  "secret_code": "<code>"
}

​
Sharing the result

Once the upload completes, share the URL and secret code with the recipient. They run: 
fzx2 exec http://192.168.1.50:5000/pull/a1b2c3d4-e5f6-7890-abcd-ef1234567890
They will be prompted to enter the secret code before the download proceeds.

​
Errors

MessageCause
File not found!The specified .507ex path does not exist.
The secret code is generated by the CAR server at upload time. Keep it confidential — anyone with both the URL and the secret code can download and execute the file.
Start a local CAR server with fzx2 start_server before uploading. See the start-server reference for details.

Build docs developers (and LLMs) love

Get started for freeTalk to us