Steps to install Seed Surveys in your own Server:

SSH into the server

ssh root@YOUR_SERVER_IP

Add more memory

fallocate -l 4G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab
free -h

Run Seed Self-hosted Script

curl -fsSL https://deploy.seed.hyper.media | sh

Clone the Repo

cd /root
git clone https://github.com/seed-hypermedia/seed.git seed
cd seed
git fetch origin
git checkout Form-with-seed-docs
git reset --hard origin/Form-with-seed-docs

Check the web config

cat /opt/seed/web/config.json

For Seed Surveys private feedback, it should include:

{
  "registeredAccountUid": "SEED_SURVEYS_ACCOUNT_UID",
  "feedbackDestinationAccountUid": "SEED_SURVEYS_ACCOUNT_UID",
  "feedbackDestinationLabel": "Seed Surveys",
  "feedbackSignerAccountUid": "SEED_SURVEYS_ACCOUNT_UID",
  "feedbackDestinationCapabilityCid": "CAPABILITY_CID_GRANTING_WRITE_TO_SIGNER",
  "feedbackDocumentVisibility": "private"
}

If you edit it:

nano /opt/seed/web/config.json

Validate JSON:

jq . /opt/seed/web/config.json

Build the web Docker image

Run from ~/seed:

docker build -t seedhypermedia/web:branch-test -f frontend/apps/web/Dockerfile .

Restart the web container

seed-deploy restart web

Check logs

seed-deploy logs web

Submit the feedback form, then look for:

[feedback] published

The successful new flow should show:

publishedBlobs: 3
destinationPublish: { origin: 'https://seed-surveys.hyper.media' }

pushProgress.blobsAnnounced: 0 may still happen, but it is now less important because the signed blobs are also published directly to Seed Surveys.

Test the feedback page

Open:

https://nodosdeconocimiento.es/feedback

Submit at least one feedback field.

Verify the created document

Copy the documentId from the web logs, then run:

curl -sG 'https://seed-surveys.hyper.media/api/Resource' \
  --data-urlencode 'id=PASTE_DOCUMENT_ID_HERE' \
  | jq

Expected result:

{
  "json": {
    "type": "document"
  }
}

If it returns:

"type": "not-found"

then the document did not reach Seed Surveys.

Common mistakes

Wrong Docker command:

docker build -t seedhypermedia/web:branch-test . -f frontend/apps/web/Dockerfileseed-deploy restart web

Correct command:

docker build -t seedhypermedia/web:branch-test -f frontend/apps/web/Dockerfile .

Then separately:

seed-deploy restart web