Skip to content
Kushal Das edited this page Mar 27, 2020 · 23 revisions

Welcome to the manualbox wiki!

Installation guide on Mac

First install latest osxfuse following their guidelines. Remember to install the Macfuse Compatibility layer too.

Install osxfuse

Then download, and install the app from the DMG file.

Usage guide

To start the application from source:

On Linux:

./devscripts/manualbox

On Mac:

Click on the App icon like any other application.

If you are running the tool for the first time, it will create a new manualbox and mount it in ~/secured directory, it will also give the you the password, please store it somewhere securely, as you will need it to mount the filesystem from the next time.

initial screen

After selecting (or you can directly type) the mount path (must be an empty directory), you should type in the password, and then click on the Mount button.

File system mounted

Now, if you try to access any file, the tool will show a system notification, and you can either Allow or Deny via the following dialog.

Allow or deny access

Every time you allow a file access, you will also see the notification message via the system tray icon.

Accessing file msg

To exit the application, first click on the Unmount, and right click on the systray icon, and click on the Exit.

How to exit from the application

Notes to remember

While the filesystem is mounted, the data is on the RAM. Means you should not put big files into this tool (mounted filesystem). Try to keep secrets, password files, or configuration files with plaintext passwords into this tool.

Usage examples

Note: remember to keep backups of any files used using this tool. As this is still beta software.

Thunderbird

You can store your thuderbird profile into this tool. That way, thunderbird will ask for access when you start the application.

ls -l ~/.thunderbird/
# now find your right profile (most people have only one)
mv ~/.thunderbird/xxxxxx.default/logins.json ~/secured/
ln -s ~/secured/logins.json ~/.thunderbird/xxxxxx.default/logins.json

SSH private key

mv ~/.ssh/id_rsa ~/secured/
ln -s ~/secured/id_rsa ~/.ssh/id_rsa
Clone this wiki locally