SpocketDOCS
DEPLOYING

Deploying

Shipping code, redeploying, and getting back to a version that worked.

Your first deploy

Point your agent at a folder and name the app. Names are lowercase letters, numbers and dashes — "mod-app", not "Mod App".

TEXT
Deploy ./my-bot to Spocket as "mod-bot". It's a Discord bot, entry point index.js.

Runtime and entry point are usually inferred: a package.json means Node and index.js, a requirements.txt means Python and main.py. Say so explicitly if your project is laid out differently.

Redeploying

Deploying to a name that already exists ships a new version of that app rather than creating a second one. The version number increments, the previous version is kept, and the container restarts on the new code.

TEXT
I changed the command handler — redeploy mod-app.
Environment values survive a redeploy. You set a token once, not on every ship.

Build logs

Each deploy records its own build output: the fetch, the dependency install, and the first lines your program printed. Open a version on the app’s Deploys tab to read it.

This is separate from the live console. The console is a rolling tail that the next deploy overwrites; a build log belongs to one version and stays with it, which is what you want when the question is "what changed between v3 and v4?".

Rolling back

Every version you have deployed is still there.

TEXT
That broke something. Roll mod-app back to the previous version.

The old bundle is re-served and the container restarts on it. Rolling back does not delete the newer version — you can go forward again once you have fixed it.

What to include

INCLUDELEAVE OUT
Source filesnode_modules — reinstalled from your manifest
package.json / requirements.txt.git — history is not needed to run
Config files your code reads.env — secrets go in environment variables
Static assets the app servesBuild output that can be regenerated

Agents generally get this right on their own. If a deploy is unexpectedly large, ask what it included.

PREVIOUSHow it worksNEXTEnvironment variables