small - Sync 'eM ALL - Syndir successor written in Elixir.
- Erlang OTP 18+ (required)
- Elixir 1.4+ (required)
- macOS 10.10+ (not really required, but I don't use/test other workstation platforms. Also
bin/mac_listenerhas to be replaced with some Linux equivalent like inotify-tools. Feel free to add support for it if You like!)
- Supervised "Let it crash" architecture with basic self healing.
- SSH Public Key authentication only (with encrypted keys support)
- Stream file of any size to remote through SFTP (SSH) channels
- Persistent Queue and History (aMnesia disk only backend by default)
- Support for text database dumping/ loading (erl tuple format) with auto dump each 6 hours (by default)
- Basic Web History (localhost:8000) with ability to specify custom number of elements to show (localhost:8000/123)
- Asynchronous by design (whenever possible)
- Remote management through Elixir/ Erlang console. By default Small runs as "smallENV" - where ENV is one of modes: test, dev, prod (
epmd -namesto see available applications)
By default Small keeps it's data under ~/Library/Small/ (or ~/.small/ under other POSIX systems)
Since version 0.12.1 Small uses external dynamic configuration under ~/Library/Small/config.ex (or ~/.small/config.ex respectively). File contains an Elixir Keyword very similar to JSON.
Below's an example of the configuration used by me:
[
username: "dmilith",
hostname: "verknowsys.com",
ssh_port: 60022,
address: "http://s.verknowsys.com/",
remote_path: "/home/dmilith/Web/Public/Sshots/",
ssh_key_pass: "",
notifications: [
start: true,
clipboard: true,
upload: true,
error: true
],
sounds: [
start: false,
start_sound: "Glass",
clipboard: false,
clipboard_sound: "Tink",
upload: true,
upload_sound: "Hero",
error: true,
error_sound: "Sosumi"
],
open_history_on_start: false
]I use it with Nginx configuration on my server like this:
server {
listen 80;
server_name s.verknowsys.com;
location / {
return 301 https://s.verknowsys.com/$request_uri;
}
autoindex off;
index index.html;
}
server {
listen 443 ssl http2;
ssl_certificate_key /home/dmilith/.acme.sh/s.verknowsys.com/s.verknowsys.com.key;
ssl_certificate /home/dmilith/.acme.sh/s.verknowsys.com/fullchain.cer;
server_name s.verknowsys.com;
root /Web/Sshots/;
ssl_protocols TLSv1.3 TLSv1.2;
ssl_session_timeout 1d;
ssl_session_cache shared:SSL:10m;
ssl_session_tickets off;
ssl_stapling on;
ssl_stapling_verify on;
# enable HSTS for A+ grade:
add_header Strict-Transport-Security "max-age=63072000" always;
add_header X-Frame-Options DENY;
add_header X-Content-Type-Options nosniff;
add_header X-XSS-Protection "1; mode=block";
autoindex off;
}Our default page when no file name is specified in HTTP path:
<body>
<h1>Nothing's here. Go away!</h1>
</body># Build and install "Small":
bin/release
(sudo) bin/install
# Launch Small in console mode:
bin/console
# Start main supervisor:
> SyncSupervisor.start_link
# there's /Projects/small directory hardcoded in this xml file.
cp $(pwd)/LaunchAgents/com.verknowsys.SyncEmAll.plist ~/Library/LaunchAgents/
`
## ROADMAP (Work In Progress):
1. Distributed History, including multi-workstation sync.
2. Decentralised/ Distributed configuration.