SOURCE · ZIP

Deploy from a ZIP archive

Build a clean, portable archive that Botkeep can inspect without hidden local dependencies or leaked secrets.

5 min readUpdated 28 Aug 2026Beta documentation
Product preview

The interface is functional with local demo data. Live hosting, provisioning and production security controls are not connected yet.

Before you start
  • A supported Node.js or Python project
  • A local copy of the project with secrets removed
  • A start command tested from the project root

1. Put the project at the archive root

When the ZIP is opened, Botkeep should find package.json or requirements.txt without walking through an extra outer folder. A predictable root makes runtime detection and start-command suggestions more reliable.

recommended archive shapeexample
moderation-bot.zip
├── package.json        # or requirements.txt
├── package-lock.json   # when using npm
├── src/
│   └── index.js
└── README.md

2. Remove local and sensitive files

  • Do not include .env, tokens, SSH keys or provider credentials.
  • Exclude node_modules, .venv, __pycache__, build caches and editor metadata.
  • Exclude .git unless a future workflow expressly requires repository history.
  • Include only the source and data the bot genuinely needs.

3. Upload, inspect and confirm

Choose ZIP in the creation wizard, select the archive, review the detected runtime and provide the start command when detection is uncertain. The current upload step simulates the selection and does not send your archive to a server.

4. Treat every update as a new revision

Keep the original project outside Botkeep, create a fresh archive for each release and retain an independent copy of persistent data. A hosting backup must never be the only copy of your source.