PS-pocketEdge Documentation
Everything you need to install and use PS-pocketEdge: setting up servers, running containers, deploying apps, databases, Kubernetes, and administration. Pick a topic from the sidebar, or browse by section below.
Getting Started
Welcome to PS-pocketEdge
What PS-pocketEdge does, how its pieces fit together, and where to start.
Installing PS-pocketEdge
Install on macOS, Windows or Ubuntu with the guided setup, and what it puts on your computer.
Your first ten minutes
A short tour of the app: the menu, the resource bar, and running your first container.
Servers & Containers
Servers and agents
Add machines to PS-pocketEdge, read their status, and remove ones you no longer need.
Working with containers
Create, control, configure and schedule containers across all your servers.
Logs and terminals
Follow and search container logs, get AI summaries, and open shells in containers and servers.
Alerts and insights
Get alerted when containers break your rules or behave unusually, and right-size their limits.
Images, Networks & Volumes
Deployments
Compose files
Create and edit the Compose files you deploy, keep their history, and share settings between them.
Deploying apps
Deploy a Compose file with pre-deployment checks, then watch, scale, update and roll it back.
Git, builds and auto-deploy
Connect Git repositories, build images from Dockerfiles, and redeploy on every push.
Deployment history and reports
Find failed or waiting deployments, read health and revision details, and trace a release through its timeline.
Git reports and environment comparisons
Read undeployed commits, compare development through production, and export the filtered report with a worked promotion example.
Compose comparisons and drift
Compare saved YAML versions, compare deployed configuration with current content, and interpret Git and runtime drift.
Approvals and environments
Require approval, change records and maintenance windows for deployments, and review the audit trail.
Databases
Deploying databases
Run production-ready databases from the marketplace and manage their credentials.
Backups, clones and migrations
Back up databases, restore data into another instance, clone, and move between versions.
PostgreSQL administration
Monitor PostgreSQL, manage sessions, run SQL, and create users and databases.
Kubernetes
Administration
Users, roles and sign-in
Add users, choose between Admin and Viewer, and decide whether this computer needs a login.
Running the control plane on a server
Host the control plane on a server or cloud VM so you and your agents can reach it from anywhere.
CLI commands reference
Install pse, sign in, and use CLI commands for servers, containers, Compose deployments, databases, backups, images and Kubernetes.
Troubleshooting
Fixes for the most common problems with installing, servers, builds and deployments.