Skip to content

QUICK_START.md

Latest commit

 

History

History
114 lines (88 loc) · 3.68 KB

QUICK_START.md

File metadata and controls

114 lines (88 loc) · 3.68 KB

QUICK_START.md

Base environment

# prevent logout stopping services
loginctl enable-linger mnemo

pre-install

# install desktop-commander globally for the mnemo user
systemd-run --quiet --machine=mnemo@.host --user --collect --pipe --wait /bin/bash -lc \
  'source /opt/nvm/nvm.sh && npm install -g --ignore-scripts @wonderwhy-er/desktop-commander'

# deploy desktop-commander config
systemd-run --quiet --machine=mnemo@.host --user --collect --pipe --wait \
  sh -c 'cp -v ~/git/mnemo/deploy/desktop_commander_config.json /etc/mnemo/desktop_commander_config.json'

pip / python env

conda env create -f ./environment.yml
pip install -e '.[presence,tool-cache,server,app]'

deploy systemd units

Tip

Configure services first — docs/CONFIGURE.md

gateway@.service is the shared template for all MCP gateway services. Deploy it once, symlink per service.

# deploy shared gateway template
systemd-run --quiet --machine=mnemo@.host --user --collect --pipe --wait \
  sh -c 'cp -v ~/git/mnemo/deploy/gateway@.service ~/.config/systemd/user/gateway@.service'

# symlink per service
systemd-run --quiet --machine=mnemo@.host --user --collect --pipe --wait \
  sh -c 'cd ~/.config/systemd/user && \
    ln -sf gateway@.service desktop-commander@.service && \
    ln -sf gateway@.service presence@.service && \
    ln -sf gateway@.service memory@.service && \
    ln -sf gateway@.service tool-cache@.service'

# hearth (standalone)
systemd-run --quiet --machine=mnemo@.host --user --collect --pipe --wait \
  sh -c 'cp -v ~/git/mnemo/deploy/hearth.service ~/.config/systemd/user/hearth.service'

deploy confs

systemd-run --quiet --machine=mnemo@.host --user --collect --pipe --wait sh -c '
  cp -v ~/git/mnemo/deploy/desktop-commander.conf /etc/mnemo/desktop-commander.conf
  cp -v ~/git/mnemo/deploy/presence.conf          /etc/mnemo/presence.conf
  cp -v ~/git/mnemo/deploy/memory.conf            /etc/mnemo/memory.conf
  cp -v ~/git/mnemo/deploy/tool-cache.conf        /etc/mnemo/tool-cache.conf
  cp -v ~/git/mnemo/deploy/hearth.conf            /etc/mnemo/hearth.conf
  cp -v ~/git/mnemo/deploy/tunnel-watchdog.conf   /etc/mnemo/tunnel-watchdog.conf
'

watchdog

# script → /etc/mnemo/
cp -v ~/git/mnemo/deploy/tunnel-watchdog.py /etc/mnemo/tunnel-watchdog.py

# service + timer → mnemo's systemd user dir
systemd-run --quiet --machine=mnemo@.host --user --collect --pipe --wait sh -c '
  cp -v ~/git/mnemo/deploy/tunnel-watchdog.service ~/.config/systemd/user/tunnel-watchdog.service
  cp -v ~/git/mnemo/deploy/tunnel-watchdog.timer   ~/.config/systemd/user/tunnel-watchdog.timer
'
# secrets (fill in values from mcp-secrets.conf.example first)
systemd-run --quiet --machine=mnemo@.host --user --collect --pipe --wait \
  sh -c 'cp -v ~/git/mnemo/deploy/mcp-secrets.conf /etc/mnemo/mcp-secrets.conf && \
         chmod -v 660 /etc/mnemo/mcp-secrets.conf'

reload daemon

systemd-run --quiet --machine=mnemo@.host --user --collect --pipe --wait \
  sh -c 'systemctl --user daemon-reload'

start services

systemd-run --quiet --machine=mnemo@.host --user --collect --pipe --wait sh -c '
  systemctl --user enable --now desktop-commander@2095
  systemctl --user enable --now presence@2086
  systemctl --user enable --now memory@2082
  systemctl --user enable --now tool-cache@2088
  systemctl --user enable --now hearth
  systemctl --user enable --now tunnel-watchdog.timer
'

Ports (2095, 2086, etc.) are passed as MCP_LOCAL_PORT via the @<port> specifier — adjust to suit your setup.

Tip

For any issue, consult

docs/TROUBLESHOOTING.md