FAQ
Hosts → web1 → Ping
If ping shows bash and the user you expect, most of the questions below are already answered for that host.
Does it need root?
No. SSH as the user who owns the app. Root or sudo is needed only for the steps that write outside that user's home: packages, systemd units, nginx configs. Scope sudo to those commands. A deploy of a static site into a directory the user owns does not need root at all.
Does it work on Windows servers?
No. Targets need bash and the modules use GNU tools such as stat -c. You can use PlainShip from a browser on Windows. Windows is not a deploy target.
Does it install an agent?
No. The SSH session ends and nothing of PlainShip keeps running on the server, except the files you deployed and a helper script under the app's .dp/ directory. That script is not a service.
Do I install anything?
No. PlainShip is a hosted service at app.plainship.dev, plus a mobile app. There is no download, no package, and no self-hosted edition.
Does the server need Docker?
No. Docker is never required on a target.
Does it work on Alpine or BusyBox?
Alpine, if you install bash. A pure BusyBox userland is not enough: the scripts need bash, and file ownership uses GNU stat. See Troubleshooting.
Can two people share one vault?
No. Each account has its own vault. Share a project with a role instead. Jobs use the owner's keys. Collaborators do not see secret values. See Team sharing.
What if I lose the passphrase?
If you mean the account password, a manager or the email reset can set a new one and the vault stays. If you set a separate master password for the vault and lost it, that vault cannot be opened. Details and the cases in between are in Team sharing and recovery.
Why did a dry run not show a diff?
Check mode lists tasks. It does not simulate copy, template, or package. Only debug, set_fact, and fail run. See Idempotency and dry runs.
Why did my schedule not run?
It is paused, the account is on the Free plan (schedules are Pro), or the cron time has not come yet. Missed runs are not replayed. See Where jobs run.
Can I import Ansible playbooks?
You can rewrite small ones. You cannot point PlainShip at a role or a collection. The map is in Migrating from Ansible.
Where is my data stored?
In your account on PlainShip. PlainShip staff can see project names and sizes. They cannot open your vault. Backups you create are encrypted with the backup password you chose.
Is there a mobile app?
Yes. The Android app is linked from plainship.dev/mobile-app. The dashboard also works in a phone browser.