Skip to content

Linux Installation

SchemaDock for Linux installs as a systemd service under a dedicated schemadock user.

SchemaDock 0.1.5 packaging preserves Unix executable modes and LF shell-script line endings, so no manual chmod, dos2unix, or sed repair should be required.

New installation

  1. In SchemAlign, open Administration -> SchemaDock.
  2. Create or select the pending Dock registration.
  3. Open Install & Health.
  4. Choose New Installation and download the Linux install bundle.
  5. Move the bundle to the Linux host.
  6. Extract the package according to the included INSTALL.txt and bootstrap instructions.
  7. Run the installer with sudo.
  8. Return to SchemAlign Administration and confirm the Dock becomes Enrolled and Online.

For the generic versioned Linux package, the validated install flow is:

tar -xzf SchemaDock-<version>-linux-amd64.tar.gz
cd SchemaDock-<version>-linux-amd64
sudo ./install.sh

Installed locations

The validated Linux layout is:

/usr/local/bin/schemadock
/etc/schemadock/config.json
/var/lib/schemadock/identity.json
/etc/systemd/system/schemadock.service

Verify the service

Check service status:

systemctl status schemadock --no-pager -l

Check recent logs:

journalctl -u schemadock --no-pager -l

Check the installed version:

/usr/local/bin/schemadock version

A healthy startup normally includes messages indicating that SchemaDock started and connected to the SchemaDock gateway.

Update or reinstall

An enrolled Linux Dock does not require a new bootstrap for normal updates.

Extract the newer package and run:

sudo ./install.sh

The installer detects the existing installation, preserves the local identity, replaces the binary/service files as required, and restarts the service.

Uninstall

From an extracted SchemaDock package:

sudo ./uninstall.sh

Review the uninstall output before removing any retained configuration or identity data manually.