Installation

PocketOne is one executable, pocketone. It is built on PocketBase v0.41 and takes the same commands and flags, plus its own.

Homebrew (macOS and Linux)

brew install pockethost/tap/pocketone

The formula lives in pockethost/homebrew-tap.

Download a release

Download the zip for your platform from Releases, unzip it, and put pocketone somewhere on your PATH.

Build from source

With Go installed:

git clone https://github.com/pockethost/pocketone.git
cd pocketone/examples/pocketone
go build -o pocketone .

Run it

pocketone serve

Open http://127.0.0.1:8090/_/ to create your first superuser, as in PocketBase.

To start a site with server-rendered pages:

pocketone pages create myapp
cd myapp
pocketone serve --dev --dir ./pb_data

In dev mode (serve --dev), an app with no SMTP settings doesn't send mail through the system's sendmail. PocketOne catches the mail and shows it at http://127.0.0.1:8025.

Upgrade

pocketone upgrade

This replaces the executable with the latest release. The old one is kept beside it as pocketone-<version>, never deleted, so you can go back.

Moving from PocketBase

PocketOne reads the same pb_data, pb_hooks, pb_migrations and pb_public folders. Point it at your existing data directory with --dir, as you would with pocketbase. Back up pb_data first.