Fork: 0
root / navi-1
Download ZIP 627commits
Transfer to URL with SHA
navi-1 / deploy /
latest commit 2134737535
@Eugene Sukhodolskiy Eugene Sukhodolskiy authored 20 hours ago
..
README.md deploy: one-command server bundle (dockerized postgres + systemd) 20 hours ago
docker-compose.yml deploy: one-command server bundle (dockerized postgres + systemd) 20 hours ago
env.template deploy: one-command server bundle (dockerized postgres + systemd) 20 hours ago
install.sh deploy: one-command server bundle (dockerized postgres + systemd) 20 hours ago
README.md

Deployment

A self-contained Navi module for a server: dockerized PostgreSQL + the Navi API server under systemd + navi-code in PATH. One command, SSH-only access, web UI off by default.

Install

ssh server
git clone -b deploy <repo-url> navi-1 && cd navi-1
bash deploy/install.sh

After the install finishes, fill in the one remaining secret and restart:

$EDITOR .env            # OLLAMA_API_KEY=<your Ollama Cloud key>
sudo systemctl restart navi
navi-code               # terminal client, ready to work

What the default deployed state looks like

Piece State
Navi API server systemd navi.service, Restart=always, starts on boot, binds 127.0.0.1:8000
PostgreSQL docker container navi-postgres (pgvector image), restart: always, bound to 127.0.0.1:5432, data in the navi-pgdata volume
Web UI (/, /assets, /admin, debug panels, navi_ui MCP) off (NAVI_WEBCLIENT_ENABLED=false)
Auth off (NAVI_AUTH_ENABLED=false) — trusted single-server module, the API listens on localhost only
Terminal client navi-code symlinked into /usr/local/bin, talks to http://localhost:8000
LLM Ollama Cloud (OLLAMA_HOST=https://ollama.com), model priority lists come from the profile configs

Branch layout

  • master — the full project, unconfigured, with all deployment machinery (deploy/, the NAVI_WEBCLIENT_ENABLED / NAVI_HOST / NAVI_PORT flags, the navi-server launcher).
  • deploy — identical to master except for a committed .env with the deployment defaults filled in. Deploying = git clone -b deploy.

Re-enabling the web panel later

Nothing is removed — the webclient and its code are all in the tree:

# in .env:
NAVI_WEBCLIENT_ENABLED=true
NAVI_UI_MCP_ENABLED=true
sudo systemctl restart navi

For remote browser access, tunnel or reverse-proxy to the API port; auth is off by default, so keep it behind SSH or enable NAVI_AUTH_ENABLED first.

Day-2 operations

systemctl status navi          # server supervision
journalctl -u navi -f          # live logs
sudo docker compose -f deploy/docker-compose.yml --env-file .env ps
sudo docker exec -it navi-postgres psql -U navi -d navi

Updating: git pull && sudo systemctl restart navi (the install script is idempotent — re-running it after a pull also refreshes the venv).

Files

  • install.sh — everything above, in one command
  • docker-compose.yml — the postgres container
  • env.template — copied to .env on first install; the deploy branch carries a filled-in copy as its only diff from master