Install on Ubuntu

OneSVD installs from source with one command. The installer pulls the toolchains it needs (Go and Node), clones the repo, builds the watcher, hub, and web client, and registers the three components as systemd user services so they restart on crash and start at boot.

One-line install#

curl -fsSL https://sh.onesvd.com | bash

This clones the repository, builds everything, asks which directory to watch, and starts the services. When it finishes you'll see the web UI address — open it in your browser.

What the installer does#

In order, it:

1. Installs Go and Node if they're missing.
2. Clones the source into ~/.local/share/onesvd and links the onesvd command into ~/.local/bin.
3. Asks which directory to watch — defaulting to the directory you ran the command from.
4. Builds the watcher binary, installs the hub and client dependencies, and produces a production build of the web client.
5. Enables linger (one-time sudo), writes the systemd units, and starts the services.
6. Prints the local and network URLs.

Re-running the installer updates the source and rebuilds. It restarts the services only when the build or configuration actually changed, so an unchanged re-run leaves them running untouched.

Using onesvd right away#

The installer adds ~/.local/bin to your PATH for new shells. To use onesvd in the terminal you installed from, open a new terminal or run:

source ~/.local/share/onesvd/env

Managing the node#

After install, the onesvd command controls everything:

onesvd status      # show what's running and where it's watching
onesvd logs        # follow all three logs
onesvd restart     # bounce the services
onesvd dir PATH    # change the watched directory
onesvd uninstall   # stop and remove the services (data is kept)

See the CLI reference for the full command list.

Ports#

OneSVD uses three ports by default. Change any of them after install with onesvd config set:

onesvd config set frontend_port 8080

Next#

Head to the quickstart to add files and watch the tree update, or see configuration for the full list of settings.