SnapShield by 45Drives protects Samba file servers from ransomware. It watches file activity on your shares, scores suspicious behaviour, plants honeyfiles that no legitimate user should touch, and stops an attack before it spreads.
This repository is the public home for SnapShield's documentation and bug reports. The packages themselves come from the 45Drives package repository.
On the file server, as root:
curl -sSL https://raw.githubusercontent.com/45Drives/SnapShield-public/main/setup.sh | sudo bashThis adds the 45Drives Community repository, installs Cockpit and the SnapShield Cockpit plugin, and turns Cockpit on. Then:
- Open
https://<your-server>:9090and sign in with an administrator account. - Choose Snapshield Dashboard in the menu.
- Follow the setup wizard. It installs the rest of SnapShield and configures it.
Enterprise customers add --enterprise:
curl -sSL https://raw.githubusercontent.com/45Drives/SnapShield-public/main/setup.sh | sudo bash -s -- --enterprisePrefer to read a script before running it? Download it first, then run it: curl -sSLO https://raw.githubusercontent.com/45Drives/SnapShield-public/main/setup.sh && less setup.sh && sudo bash setup.sh. Add --dry-run to see every change without making any. The installation guide covers all options and manual setup.
| Operating system | Versions |
|---|---|
| Rocky Linux, RHEL, AlmaLinux | 8, 9 |
| Ubuntu | 20.04 LTS, 22.04 LTS |
Start with the documentation index, or jump to:
- Installation
- Connecting Samba — protect your shares and check the connection
- Getting started
- SnapShield dashboard
- Control Panel — manage many SnapShield servers from one place
- Licensing — Community and Enterprise
- Day-to-day operation — responding to alerts, restoring files, bans, honeyfiles, fire drills and routine checks
- Troubleshooting and FAQ
| Community | Enterprise | |
|---|---|---|
| Price | Free | Paid subscription per server, with a six-month free trial |
| Ransomware protection | Included | Included |
| Control Panel management | — | Included |
| Support | Documentation, the 45HomeLab Forum and GitHub issues | 45Drives support at info@45drives.com — see SUPPORT.md |
Every server starts on Community, and the license — not the package repository — decides the edition: an Enterprise license unlocks Enterprise features on a server installed from either repository. See Licensing for the full comparison.
Ask questions and get help from other users on the 45HomeLab Forum. See SUPPORT.md for all the ways to get help.
Open an issue and pick a template. Please include your SnapShield version and operating system, and remove hostnames, IP addresses and license keys from any logs you paste.
Found a security vulnerability? Do not open a public issue. Follow SECURITY.md instead.
Release notes are published under Releases.