[!WARNING] Back up your vault before using this plugin. By default, it uploads attachments to Copyparty based on your current Obsidian attachment settings, and it may remove the local files from your vault without rewriting the links in your notes.

If you want to migrate gradually, use the migration command to upload and rewrite attachments note by note.

To test the plugin safely before fully committing, temporarily change Settings → Files & Links → Default location for new attachments to a separate folder and try it there first.

Paste or drop any media file into Obsidian and it gets uploaded to your self-hosted Copyparty server automatically. The file never touches your vault — only the embed is inserted.

Demo

What it does

Installation

If you have downloaded the plugin through the community plugins tab, skip the installation section and head over towards Configuration.

1. Download Release on Github

Download the latest release, ensuring you have downloaded main.js & manifest.json.

2. Install

Copy the files into your vault's plugin folder:

# make the directory "copyparty-uploader" under .obsidian/plugins if it doesnt exist
cp main.js manifest.json ~/path/to/vault/.obsidian/plugins/copyparty-uploader

# this is what the directory should look like
.obsidian/plugins/copyparty-uploader/
  main.js
  manifest.json

If you are on windows, drag the files to the plugins directory under your vault, ensuring you have made a folder called "copyparty-uploader".

Then enable the plugin in Obsidian → Settings → Community Plugins. (Should be called "Copyparty Uploader")

Development

Installation steps for development. Follow steps above instead if you just want to use the plugin without developing it.

1. Build

git clone https://github.com/r3quisitevariety/copyparty-obsidian.git
cd copyparty-obsidian
npm install
npm run build

2. Install

Copy the output files into your vault's plugin folder:

# make the directory "copyparty-uploader" under .obsidian/plugins if it doesnt exist
cp main.js manifest.json ~/path/to/vault/.obsidian/plugins/copyparty-uploader

# this is what the directory should look like
.obsidian/plugins/copyparty-uploader/
  main.js
  manifest.json

Then enable the plugin in Obsidian → Settings → Community Plugins. (Should be called "Copyparty Uploader")

Configuration

1. Configure

Go to Settings → Copyparty Uploader:

• Server URL: http://your-ip-here:3923 (no trailing slash)
• Upload path: /obsidian-uploads or wherever you want files to land
• Username / Password: leave blank if your upload path has w: * (world-writable)

Hit Test to confirm connectivity.

2. Copyparty config

Make your upload directory world-writable so no credentials are needed:

[/obsidian-uploads]
/path/to/obsidian-uploads
accs:
  rwda: you
  rw: *        ← world read+write, no password

Or keep it write-only from outside and enter your credentials in plugin settings.

Also ensure you have the following option in your global config to allow copyparty to properly communicate with obsidian:

[global]
allow-csrf

Note that this plugin has been tested on a LAN + tailscale setup. The allow-csrf option is unsafe on the public internet, and the author advises against using it in general. A more secure setup would involve a reverse proxy configuration, but I have not tested that yet.

Migrate existing local attachments

Run the command palette → Copyparty: Upload all local attachments in this note to retroactively move any ![[local-file.png]] or ![](https://raw.githubusercontent.com/r3quisitevariety/copyparty-obsidian/HEAD/relative/path.mp4) references out of your vault and onto the server.

Notes

• Filenames are sanitized with timestamps + original filename before upload.
• If upload fails, Obsidian's default paste behaviour is blocked for that file and an error notice is shown. The file is not saved locally as fallback — this is intentional for a thin-client setup.
• Auth credentials are stored in .obsidian/plugins/copyparty-uploader/data.json (plain text). Fine for a local homelab, not for anything public-facing.