PocketADM

PocketADM

Your server, in your pocket.

New here? Install PocketADM on a server

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

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

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

PocketADM

Connect this app to your server.

No server yet? Install PocketADM

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

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

Then tap Add a server above with its address and password.

PocketADM
Plan
    Agent is working…

    Updates

    Server checks

    Add new

    one-tap installs
    Settings

    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

    PocketADM 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. PocketADM 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…

    Autonomy & alerts

    How the agent behaves on long tasks, and when it pings your phone.

    When it has worked a while

    Check in every steps
    …or every min (0 = off)

    Push notifications

    Get a push when the agent pauses to ask, or stops on an error. Uses ntfy — paste your topic URL.

    Tasks & permissions

    When the agent hits a wall it can’t pass (missing rights), it lands here — with a plain explanation and a way to resolve it in a focused session.

    No open tasks.

    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 in the top bar. 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

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

    Scheduled checks

    Backup

    Everything PocketADM knows — settings, API keys, chats, agent memory, installed-app definitions, audit log — in one downloadable archive. Keep it safe: it contains your keys. App data (photos, databases …) is not included — the Checks tab tells you if real backups are missing.

    Session

    PocketADM · open source server command center

    PocketADM