Skip to main content

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.