⎈

Helmsman

Your server, in your pocket.

New here? Install Helmsman on a server

SSH into your server and run the one-line installer — it sets up Docker (if needed) and Helmsman, then prints your admin password:

curl -fsSL https://raw.githubusercontent.com/maxaufknax/helmsman/main/install.sh | bash

Afterwards open http://<server>:8090 on your phone and add it to your home screen.

⎈

Services

Agent is working…

Updates

Server checks

App Store

one-tap installs for your server

Server

Loading server details…

A friendly label shown in the app. It doesn’t rename the real server.

People & access

The accounts your server is built on — who can sign in, who is an administrator, and the background service accounts that keep it running.

Loading accounts…

Passwords

Helmsman admin password

The password you use to sign in to this app. To change a Linux user’s password, use People & access above.

Appearance

Pick a look — saved on this device. Auto follows your system’s light/dark setting.

Security & activity

Two-factor authentication
…

Active sessions
Sign out every other device (a password change does this too).

Activity log
Every action — including what the AI did — is recorded here.

AI providers

Bring your own keys — they never leave this server. Enter - to remove a stored key.

Local AI

private · no keys

Run a model on this server — free, private, and offline. Helmsman uses Ollama and picks models that fit your hardware. Local models then appear in the chat model picker just like cloud ones.

Checking for a local model runtime…

AI usage

–today
–this month
–last 30 days

Agent instructions & memory

✍️ Custom instructions

Standing orders you write for the agent — how it should behave, rules to always or never follow. Added to the start of every conversation.


🧠 Memory · the agent writes this itself

What the agent has learned about your server across chats. It updates this on its own — edit or clear it anytime.

Agent tools

What the agent is allowed to do. Turn a tool off and the agent can’t use it at all. Green tools are read-only and run without asking; the rest need your approval (except in Auto mode).

Loading tools…

Default workspace

The folder new agent chats start in — usually where your server’s files and compose stacks live.

📁
…
agent’s starting folder
Advanced: allowed folders

Safety boundary — the agent and folder picker may only touch these locations (one per line).

Background agents

Sentinel

Little AI watchmen that check your server on a schedule — even when the app is closed — and report to the 🔔 bell. They only ever look (read-only): they never change anything on their own. Add an ntfy topic to also get a push to your phone.

Integrations

🔒 secured
🔒
Connect DNS providers and other APIs once, then let the agent manage them for you (e.g. “add an A record for blog.example.com”). Your tokens are stored encrypted-at-rest on this server with locked-down permissions, never shown to the AI, and injected only at the moment a request is sent. Turn any connection off to instantly cut the agent’s access.

App catalog

Helmsman’s App Store is served from an online catalog so new apps appear without updating Helmsman. Point this at your own JSON to add private apps. Leave blank to use only the built-in catalog.

Scheduled checks

Session

Helmsman · open source server command center