Running Pampas
This page covers what is specific to running Pampas, the forms app, on your server: its data, its captcha keys, its email, and what a restore changes for people who were filling in a form.
Where it runs
| Folder | /opt/pampas |
| Address | forms.<your-domain> |
| On the server | 127.0.0.1:3410 |
| Services | app, worker, db, migrate, updater |
| Settings | Pampas settings |
Pampas answers only at its own address: a request for any other name gets an error (421), except its health address /api/healthz and its assistant tools at /api/mcp. When you move the domain with foxden domain set or Admin, its address moves with it.
Its data
- Database: the forms and every answer.
- Uploaded files: the files and signatures people send with their answers, in Pampas' data folder (
pampas-data). On a server with Library, the files Pampas stores once it is linked to Library are kept in Library instead.
The nightly backup at 01:40 holds the database and the data folder. See Back up and restore.
Captcha
A form can ask for a captcha before it is sent. Pampas needs one provider's keys for it, set once for every form: Cloudflare Turnstile or hCaptcha.
In Admin:
- Open Server › Products and select Pampas.
- Under Captcha, select Set up (or Change).
- Choose the Provider, paste the Site key and the Secret key, and select Save and restart. The keys are checked with the provider before they are saved. Remove takes them away.
With the CLI: set CAPTCHA_PROVIDER (turnstile or hcaptcha), CAPTCHA_SITE_KEY and CAPTCHA_SECRET together, for example with foxden config import <file> --product pampas, then foxden restart --product pampas.
Email
Pampas sends no email until email is set up on the server: no notifications, and links are passed on by hand. It sends through Resend, or through your own mail server with SMTP_URL and EMAIL_BACKEND=smtp. See Set up outgoing email.
After a restore
foxden backup restore gives Pampas a new APP_SECRET, on the same server or a new one. The signed links Pampas already sent to respondents stop working; send them again.
Sign-in and people
With Admin on the server, people sign in to Pampas through Admin. On its own, the hand-over screen prints a setup link (/setup?token=...) that creates Pampas' first account; foxden console link --product pampas prints it again until that account exists.
Links to other apps
With Fennec on the server, Pampas sends each website form's lead to Fennec. The installer wires the link, and it takes the place of any pairing made in Pampas' own settings.