Put your app online from a .zip
Last updated
If you have a .zip of an app — from a developer, or from an AI tool that built it for you — this is the whole process.
1. Sign in
Create an account at justrunmy.app and open your dashboard.
2. Start a new app
Click Create application. The simple option is the Runny AI Agent — that's the one you want. It reads the files in your zip and works out how to run them.
3. Upload the zip
Drag the file in, or click to choose it. There's a size limit shown on the page.
If your file is too big, it's usually because it contains folders that don't need to be there — node_modules, venv, dist, bin, obj. Those are rebuilt automatically, so deleting them from a copy of the folder before zipping usually shrinks it dramatically. If you're unsure, ask whoever gave you the file to send a smaller one.
4. Answer the questions
If the app needs a password, an API key, or a token, you'll be asked for it rather than the system guessing. Paste the value in when prompted.
These are stored as settings on the app, not inside the code — which is the right place for them, and means you can change one later without a new zip.
5. Wait, then check it properly
The system builds and starts the app. When it's done you'll see a status and, if it's a website, a link.
Open the link and use the app. This is the step people skip. A green status means the app started — not that it works. Click through the thing it's supposed to do.
If it's not a website — a bot, for example — go to wherever it's supposed to appear and check it responds there.
If it doesn't work
Open the Logs tab and copy everything you see. Send that to whoever built the app. You don't need to interpret it.
Two common cases you can recognise yourself:
- The link loads nothing at all. Usually a setting inside the app rather than anything you did — your developer will know the fix.
- It worked, then data vanished after an update. The app needs storage attached. Ask your developer about adding a volume.
Do this reasonably soon after the problem — logs don't keep forever.