A command line utility to sync your personal dotfiles to an encrypted Github. This allows you to share your personal secrets across multiple machines and keep them in sync.
pipx install neutron-sync
- Private Github repository
- git-crypt installed, see https://github.com/AGWA/git-crypt/blob/master/INSTALL.md
- Ubuntu/Debian:
sudo apt install git-crypt - Redhat:
sudo yum install git-crypt - Mac:
brew install git-crypt
- Ubuntu/Debian:
git clone git@github.com:{github-user}/{repo-name}.git
cd {repo-name}
git-crypt init
nsync init `pwd`
git-crypt export-key ~/.dotfiles.key
git-crypt unlock ~/.dotfiles.key
# you may get an error if you have no files initially which is OK
adds to encrypted repo and creates link at original location
# link a directory
nsync link ~/.ssh
# link a file
nsync link ~/.tmux.confwhen files are changed
nsync save
nsync pull
While files are synced via the git repository, you need to transfer keys to the secondary machine so you can decrypt the repository. By default, it will transfer you encryption key and ssh key.
On Primary:
nsync start-transfer
# follow promptsOn Secondary:
nsync complete-transfer
# follow prompts
mv {output-dir}/.dotfiles.key ~
mkdir .ssh
chmod 700 .ssh
mv {output-dir}/id_rsa ~/.ssh
mv {output-dir}/id_rsa.pub ~/.ssh
chmod 600 ~/.ssh/*git clone git@github.com:{github-user}/{repo-name}.git
cd {repo-name}
git-crypt unlock ~/.dotfiles.key
nsync init `pwd`
nsync pull
The transfer server can be used to help assist in setting up a new machine. After initial setup, all transactions are stored in your git repository. All files stored on the transfer server are encrypted on device before being sent and only stored temporarily.
File transfers default to using https://www.neutronsync.com/. You can host your own server by running:
nsync server