Merge pull request #73 from nosecguy/patch-1
|2 weeks ago|
|circlean_fs||2 weeks ago|
|deb||6 years ago|
|diode_controller||3 years ago|
|doc||1 month ago|
|fs_get_shell/etc||3 years ago|
|kernel_config||5 years ago|
|midi||6 years ago|
|shell_utils||1 month ago|
|tests||3 years ago|
|.gitignore||4 years ago|
|CHANGELOG.md||2 years ago|
|CONTRIBUTING.md||1 month ago|
|LICENSE||10 months ago|
|README.md||1 month ago|
|copy_to_final.sh||4 years ago|
|mount_image.sh||3 years ago|
|proper_chroot.sh||5 years ago|
|run_tests.sh||4 years ago|
To prepare the SD card on Windows, you can use Win32DiskImager. On linux/macOS, use dd (see the how-to link for instructions).
The current prebuilt image is based on the 1-11-17 release of Raspbian Jessie Lite. The smallest SD card that Circlean can fit on is currently 4GB.
Question: I can’t login, what is the password?
Answer: For security reasons, it is not possible to login on the default image runinng CIRCLean/KittenGroomer (an attacker could exploit that functionality).
The only thing the default image does is booting, processing the content of the source key, copying over the files to the destination key, and finally shutting down.
This project aims to be useful when you get/find a USB key that you can’t trust, and you want to look at its contents without taking the risk of plugging it into your computer directly. The official project page can be found at [https://www.circl.lu/projects/CIRCLean/]
The Raspberry Pi Foundation has a blog post with more information about an older version of the project and details of the inspiration behind it.
CIRCLean is currently tested to work with USB keys that have FAT32, NTFS, exFAT or ext2/3/4 filesystems (ext* filesystems can only be used as source keys, not destination keys). The vast majority of USB keys will be FAT32, NTFS, and exFAT.
The content of the untrusted key will be copied or/and converted to the second (blank) key following these rules (based on the mime type as determined by libmagic):
Plug your own key in the bottom USB slot (or use any of the other slots if there are more than 2).
Note: This key should be bigger than the original one because any archives
present on the source key will be expanded and copied.
Optional: connect the HDMI cable to a screen to monitor the process.
Connect the power to the micro USB port.
Note: Use a 5V, 700mA+ regulated power supply
Wait until you do not see any blinking green light on the board, or if you connected the HDMI cable, check the screen. The process is slow and can take 30-60 minutes depending on how many document conversions take place.
Power off the device and disconnect the drives.