Troubleshooting

Every error carries a stable code, a message and, almost always, a hint. The full list is in error codes. These are the ones that come up most.

not logged in / unauthorized

You have not signed in on this machine, or the token expired or was revoked. Run rapadura login.

not_invited

Your GitHub user has not been invited yet. Send the username to the administrator and try again after the invite.

login_unavailable

GitHub login is switched off on the gateway at the moment. Ask the administrator for a token and use RAPADURA_TOKEN, or wait.

slug_taken, slug_reserved, invalid_slug

The name exists, is reserved or has an invalid character. Use lowercase letters, digits and single hyphens, and pick another name. See Rules and limits.

archive_forbidden_file

The folder contains a file that cannot go up: server-side code (.php and similar) or secrets (.env, keys). The message lists each one. Publish only the build output directory, or remove the files. There is no override.

archive_too_large / quota_exceeded

Over the size limit or the number of sites. rapadura zones shows the limits. Shrink, delete an old site, or ask the administrator for more.

publish_failed

The server refused the configuration or the post-publish check failed. The previous version is still live. Try again; if it persists, send the full message to the administrator.

The site does not open over HTTPS right after publishing

The first visit to a new address issues the certificate and can take 5 to 15 seconds. Reload. If it still fails after a minute, check rapadura sites show <name> and tell the administrator.

"command not found: rapadura"

The installer puts the binary in ~/.local/bin. Add it to your PATH (export PATH="$HOME/.local/bin:$PATH" in .bashrc/.zshrc) or call it by its full path. On Windows see Getting started.

The agent says it cannot find the MCP server

Make sure rapadura is on the PATH the agent uses, or register it with the binary's full path. Test in a terminal: rapadura whoami has to work before MCP can.

I want a site back after deleting it

The files are kept for a while. Ask the administrator to restore it and give them the full address.