Introduction to Obsidian Portable
Obsidian Portable is a portable distribution of Obsidian, the powerful plain-text markdown note-taking application. Packaged with a PortableApps.com launcher, it allows you to use Obsidian from a USB drive, cloud folder, or local directory without needing to install it on each PC.What is Obsidian Portable?
Obsidian Portable takes the full-featured Obsidian markdown editor and packages it as a completely portable application. This means:- No installation required - Run directly from any location
- Your data travels with you - All settings and vaults stay in the portable directory
- No registry changes - Leaves no trace on host computers
- Drive letter independent - Works even when your drive letter changes
Obsidian Portable uses the
--user-data-dir parameter to store all application data within the portable directory structure, ensuring complete portability.Key Benefits
True Portability
Run from USB drives, cloud storage, or any local folder. Your complete Obsidian environment moves with you.
No Installation
No admin rights needed. Extract and run - it’s that simple.
Multi-Computer Sync
Use the same Obsidian configuration across multiple computers by running from cloud storage like Dropbox or OneDrive.
Privacy First
All your notes and data remain local. No account required unless you want to use Obsidian Sync or Publish services.
Use Cases
Obsidian Portable is perfect for:- Students and Researchers - Take your knowledge base to school, library, or lab computers
- IT Professionals - Carry your documentation and notes on a USB drive
- Writers - Work on your manuscripts from any computer without setup
- Privacy-Conscious Users - Keep your notes on encrypted USB drives
- Multi-Computer Users - Seamlessly work across multiple PCs with cloud storage
Comparison with Standard Obsidian
| Feature | Standard Obsidian | Obsidian Portable |
|---|---|---|
| Installation | Required | Not required |
| Registry entries | Yes | No |
| User data location | %APPDATA% | Portable directory |
| Drive letter changes | N/A | Automatically handled |
| Admin rights | May be required | Not required |
| Leaves PC clean | No | Yes |
How It Works
Obsidian Portable uses the PortableApps.com launcher framework to:- Launch Obsidian with
--user-data-dirpointing to the portableDatadirectory - Automatically update vault paths when the drive letter changes
- Store all settings, plugins, and themes in the portable directory
- Clean up temporary files on exit
The launcher configuration (
ObsidianPortable.ini) handles path replacements automatically, updating references in obsidian.json when your drive letter changes.System Requirements
Version Information
Current version: 1.11.5 (as of January 2026)- Based on official Obsidian for Windows releases
- Regular updates following Obsidian’s release schedule
- Maintained by @Papela and PortableApps.com community
Licensing
The portable packaging is licensed under GPL-3.0. See the LICENSE file for details.Data Privacy
Your data privacy is paramount:- All notes are stored locally on your device
- No account creation required for basic use
- No data sent to servers (unless using Obsidian Sync/Publish)
- No telemetry or tracking in the portable launcher
Obsidian Portable is perfect for users who want complete control over their data location and privacy.