CLI

jollop is the Jollop command-line client. It tars a tree, streams the deploy pipeline, and manages your apps and identity.

Getting started

Already have jollop installed? Run jollop login, then jollop deploy . from your project. For an agent starting without the CLI, use the copyable setup prompt. Its public instructions include the HTTPS API route, which requires no client installation.

Configuration

jollop reads its target server and credential from flags, environment, or a config file, in that order of precedence:

--token <token> or SSC_TOKEN: your credential. This may be a user API key (from jollop login) or the operator token. Sent as Authorization: Bearer on every request.
SSC_SERVER: the control-plane URL, https://app.jollop.run for production (the bare apex serves this site, not the API). jollop login records this so later commands target the same place.
~/.config/smallcloud/env: a KEY=VALUE file (chmod 600) that login writes and logout clears. SSC_TOKEN, SSC_SERVER, and SSC_USER live here.

Commands

deploy

jollop deploy [dir]                 # a local directory (default ".")
jollop deploy <git-url>             # a public git repository
jollop deploy <archive.zip|.tar>    # an archive
jollop deploy --image <ref>         # a container image

See Ways to deploy for the details of each.

list

jollop list

Lists your apps with id, name, kind, and status. You see the apps you own (and your org’s, when an org scope is active); the operator sees everything.

jollop share <id|name>              # print the secure link, minting one only if none exists
jollop share <id|name> --rotate     # revoke the current link and issue a new one
jollop share <id|name> --public     # anyone with the URL
jollop share <id|name> --private    # operator only
jollop share <id|name> --link       # secure-link mode
jollop share <id|name> --revoke     # kill the current link
jollop share <id|name> --expire 24h # attach an expiry to the link

See Sharing & visibility.

destroy

jollop destroy <id|name>

Tears the app down and frees its URL. Irreversible.

jollop login       # email + password, or a passwordless email code; mints a user API key
jollop whoami      # show the current identity (user / operator / anonymous)
jollop logout      # revoke the session and remove the saved key

login runs the real sign-in flow and saves a durable API key to the config file, so subsequent commands are authenticated as you. See Accounts & orgs.

CLI