Skip to content

πŸ’Ό Meerschaum PortableΒΆ

Sometimes, it's not worth the hassle setting up a complete Python environment. If you're using a non-administrative account or just want to test out Meerschaum, Meerschaum Portable might be right for you.

Meerschaum Portable is a self-contained Meerschaum installation, running entirely within one directory. Download and extract the archive, and you can have Meerschaum running in seconds.

Compatability Notice

Although Meerschaum Portable has been well tested, you may still encounter problems, such as permissions issues on Mac OS. In case you cannot successfully extract Meerschaum Portable, consider following the directions for a normal install found on the Getting Started page.

InstallationΒΆ

Installing Meerschaum Portable is pretty straightforward: download and extract the archive file, then execute mrsm. Follow the steps below for more information.

Download the ArchiveΒΆ

Download the appropriate archive for your operating system. For convenience, I recommend installing the Full version, though note that the extracted folder can grow to >1 GB in size!

If you don't need all of Meerschaum's functionality and would rather save a bit of disk space, download the Minimal version. You can always install dependencies later with mrsm upgrade packages.

Extract the ArchiveΒΆ

After downloading the archive, move it to your desired location and extract its contents:

Right click the zip file and choose Extract All. Once it's finished extracting, open the folder and double click setup.bat. Allow permissions if prompted.

Extract the tar archive:

1
tar -xvf mrsm-full.tar.gz

Double-click the archive to open the Archive Utility, or use tar (see Linux instructions).

Run the ScriptΒΆ

Inside the extracted folder, there is an executable called mrsm (mrsm.bat on Windows). Run this script by double-clicking (Windows and MacOS) or via a terminal window. The first time launching may take a bit, so be patient!

UpgradingΒΆ

Oftentimes, Meerschaum Portable is a few versions behind the latest official release. To upgrade to the latest release, run the upgrade meerschaum command from within mrsm:

1
upgrade meerschaum

ResettingΒΆ

To return Meerschaum Portable to its "factory" state, delete the folder called root inside the extracted directory. The root folder contains Meerschaum data and configuration files, so make sure you back up your data before deleting!

UninstallationΒΆ

On Windows, run the included uninstall.bat script to uninstall Meerschaum. On Linux and MacOS, simply delete the extracted directory:

1
rm -rf mrsm/

Keep Meerschaum Portable in its own folder.

On Windows, the script uninstall.bat deletes the parent folder of mrsm.bat. Therefore do not keep the contents of the .zip folder by themselves on your desktop, or uninstall.bat will delete your Desktop folder!