{"id":48831,"library":"omnisync","title":"OmniSync","description":"OmniSync v2.5.0 is an open-source CLI tool for migrating entire workstations or servers to new machines. It creates a portable 'briefcase' containing installed packages, dotfiles, SSH keys, VS Code extensions, Docker containers, and secrets, then restores them on a target machine. Unlike rsync or Ansible, OmniSync offers a guided TUI and zero-config setup. It supports apt, pip, npm, cargo package managers and includes AES-256-GCM encryption for secrets. Actively maintained on GitHub with monthly releases, it requires Node.js >=18 for the npm package.","status":"active","version":"2.5.0","language":"javascript","source_language":"en","source_url":"https://github.com/sxrubyo/omnisync","tags":["javascript","migration","ssh","restore","briefcase","cli","devops","backup","sync"],"install":[{"cmd":"npm install omnisync","lang":"bash","label":"npm"},{"cmd":"yarn add omnisync","lang":"bash","label":"yarn"},{"cmd":"pnpm add omnisync","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Runtime requirement for npm-installed CLI","package":"node","optional":true}],"imports":[{"note":"The tool is a CLI, not a library. Install globally via npm, or use the install.sh script.","wrong":"","symbol":"omnisync","correct":"npm install -g omnisync"}],"quickstart":{"code":"npm install -g omnisync\nomni --help\n\n# Pack current machine into a briefcase\nomni pack --all --output /backups/my-briefcase.omni\n\n# Restore on new machine (after copying briefcase)\nomni restore /backups/my-briefcase.omni\n\n# Use interactive TUI\nomni","lang":"javascript","description":"Installs OmniSync globally, shows help, packs the current machine, and restores on a new machine."},"warnings":[{"fix":"Check https://github.com/sxrubyo/omnisync/releases for current SHA256 before running install.sh","message":"The install script hash in README is for v2.3.2, not latest. Always verify against GitHub releases.","severity":"gotcha","affected_versions":">=2.0.0"},{"fix":"Store passphrase in a password manager. There is no recovery mechanism.","message":"Secrets pack encryption uses AES-256-GCM. Losing the passphrase means permanent data loss.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Use `omni pack` without --all, or omit the flag.","message":"The --all flag in v2.4.0+ is now default behavior. Explicit --all will be removed in v3.0.","severity":"deprecated","affected_versions":">=2.4.0"},{"fix":"Ensure Python 3.10+ is available if using install.sh, or use npm package on Node 18+.","message":"OmniSync requires Python 3.10+ for install.sh script, but npm package requires Node >=18.","severity":"gotcha","affected_versions":">=2.0.0"},{"fix":"Ensure Docker daemon is running and user has socket access before packing.","message":"Docker container migration only works if Docker socket is accessible. Containers are not exported if Docker is not running.","severity":"breaking","affected_versions":">=1.0.0"}],"env_vars":null,"search_vec":"'-256':70 '18':85 'activ':75 'ae':69 'ansibl':48 'apt':61 'backup':97 'briefcas':24,94 'cargo':64 'cli':9,95 'code':32 'config':57 'contain':25,35 'creat':21 'devop':96 'docker':34 'dotfil':28 'encrypt':72 'entir':13 'extens':33 'gcm':71 'github':78 'guid':52 'includ':68 'instal':26 'javascript':90 'key':30 'machin':19,44 'maintain':76 'manag':66 'migrat':12,91 'month':80 'new':18 'node.js':84 'npm':63,88 'offer':50 'omnisync':1,2,49 'open':7 'open-sourc':6 'packag':27,65,89 'pip':62 'portabl':23 'releas':81 'requir':83 'restor':39,93 'rsync':46 'secret':37,74 'server':16 'setup':58 'sourc':8 'ssh':29,92 'support':60 'sync':98 'target':43 'tool':10 'tui':53 'unlik':45 'v2.5.0':3 'vs':31 'workstat':14 'zero':56 'zero-config':55","created_at":"2026-06-07T16:58:41.786807+00:00","updated_at":"2026-06-07T16:58:41.786807+00:00","problems":[{"fix":"Do not require/import it. Use `npm install -g omnisync` and run `omni` from shell.","cause":"OmniSync is not a Node library; it's a CLI tool.","error":"Error: Cannot find module 'omnisync'"},{"fix":"Download fresh script from GitHub releases and verify against the official SHA256 listed there.","cause":"Checksum mismatch due to outdated README hash or modified script.","error":"sha256sum: install.sh: FAILED"},{"fix":"Ensure SSH agent is running and keys are added: eval $(ssh-agent) && ssh-add","cause":"SSH agent or keys not configured properly on source machine.","error":"Permission denied (publickey) when running omni pack --ssh"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/sxrubyo/omnisync#readme","github":"https://github.com/sxrubyo/omnisync","docs":null,"changelog":null,"pypi":null,"npm":"omnisync","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}