Skip to main content

Uploading & Creating Files

Add files to your Docket or create new documents and scripts.

Upload Methods​

Drag and Drop​

  1. Open the Files page
  2. Drag files from your computer
  3. Drop them on the file area
  4. Files are uploaded and encrypted (if encryption is enabled)

Click to Upload​

  1. Open the Files page
  2. Click the Upload button
  3. Select files from the file picker
  4. Files are added to your storage

Creating Files​

Create Button

Click the Create button to make a new file directly in Docket.

Create New File

Enter a filename (including extension) and click Create File. Supported file types include:

  • .txt — Plain text documents
  • .md — Markdown files
  • .sh — Shell scripts
  • .py — Python scripts
  • .js — JavaScript files
  • And other code file types

Editing Files​

The Code Editor​

Save Script

When you open a code or text file, Docket provides a built-in editor with:

  • Syntax highlighting — Language-aware coloring
  • Line numbers — Easy navigation
  • Modified indicator — Shows unsaved changes
  • Save button — Save your changes

Click Edit to modify the file, then Save when done.

Running Scripts​

Docket can execute shell scripts and code files directly.

Running a Script​

Run Script

After saving a script file, click the Run button to execute it.

Execute Code Dialog​

Execute Code Modal

Before running, you'll see a confirmation dialog showing:

  • Language — The detected script type (bash, python, etc.)
  • Warning — Reminder that code runs with your permissions
  • Working directory — Where the script will execute
  • Code preview — The exact code that will run
  • Confirmation checkbox — You must acknowledge the risk

Choose how to run the script:

  • Run in App — Execute within Docket and see output
  • External Terminal — Open in your system terminal
caution

Only run scripts you understand and trust. Scripts have full access to your user permissions and can modify files, access the network, and perform other actions.

Script Output​

Script Output

After running, you'll see:

  • Exit status — Success or failure with exit code
  • Execution time — How long it took
  • Output — The script's output text
  • Save button — Save the output as a new file

Click the save icon next to the output to save it to your Files for reference.

File Size Limits​

  • Individual files: No hard limit (depends on available space)
  • Total storage: Limited by your Docket drive capacity (128GB)

Consider that AI models take significant space. Check Settings for current storage usage.

What Happens on Upload​

With Encryption Enabled​

  1. File is read into memory
  2. Random encryption key is generated
  3. File is encrypted with AES-256-GCM
  4. Encrypted file is saved with random filename
  5. Original filename and key stored in encrypted database

Without Encryption​

  1. File is copied to storage
  2. Original filename is preserved
  3. File metadata stored in database

Organizing Files​

Rename Files​

  1. Right-click the file
  2. Select Rename
  3. Enter the new name
  4. Press Enter

Delete Files​

  1. Right-click the file
  2. Select Delete
  3. Confirm deletion
warning

Deleted files cannot be recovered. Ensure you have backups of important files.

Chat Image Attachments​

When you attach images to chat messages:

  1. Images are automatically saved to storage
  2. Stored in chat-images/ subdirectory
  3. Associated with the message in the database
  4. Persist across sessions

Tips​

  • Check available space before uploading large files
  • Use descriptive names to find files easily
  • Export important files as unencrypted backups
  • Delete unused files to free up space
  • Save script output to keep a record of executions