Skip to main content

Updating scd-server to a new version

Updating scd-server means replacing the binary and restarting — nothing more. Your data/ directory (config, cached license, and everything else) is untouched, and there are no license files to re-copy: everything scd-server needs to validate your license ships in the binary, and your license key is already stored.

Download the new binary for your platform from your license portal, exactly as you did for the initial install. Optionally verify the binary before using it.

Back up the database first

Before upgrading, copy data/scd.db somewhere safe. Upgrades are effectively one-way — a newer scd-server upgrades the database format on first boot, and an older binary will refuse to start against a database a newer one has opened (it says so clearly rather than risk your data).

Standalone (running the binary directly)​

Stop the running server (Ctrl-C, or however you started it), replace the binary, and start it again.

Linux / macOS

# from the scd-server directory, with the new binary downloaded alongside
mv scd-server-linux-x64 scd-server-linux-x64.old      # or scd-server-macos-x64
mv ~/Downloads/scd-server-linux-x64 ./
chmod +x scd-server-linux-x64
./scd-server-linux-x64 --version    # confirm the new version
./scd-server-linux-x64

Windows

Replace scd-server-win-x64.exe with the new download (stop the running process first), then:

scd-server-win-x64.exe --version
scd-server-win-x64.exe

As a service​

Stop the service, swap the binary, start the service.

Linux — systemd

sudo systemctl stop scd-server
sudo cp scd-server-linux-x64 /opt/scd-server/scd-server-linux-x64
sudo chown scd-server:scd-server /opt/scd-server/scd-server-linux-x64
sudo chmod +x /opt/scd-server/scd-server-linux-x64
sudo systemctl start scd-server
sudo systemctl status scd-server
sudo journalctl -u scd-server -n 50    # confirm a clean start

Windows — NSSM

nssm stop scd-server
copy /Y scd-server-win-x64.exe "C:\scd-server\scd-server-win-x64.exe"
nssm start scd-server
nssm status scd-server

macOS

macOS runs standalone only (a service manager is on the roadmap) — follow the standalone steps above.

After updating​

  • Confirm the version: ./scd-server --version (or check the dashboard footer).
  • Check the log for a clean start — an existing database is migrated automatically on boot.
  • Licensing continues seamlessly: the cached lease is reused and renews as normal. No re-activation is needed.
Updated key file

A normal update needs no key files. On the rare occasion Activemind provides an updated key file, support will send it with instructions on where to place it. Otherwise there is nothing to do.