How to host a web app on Schokr

You can host a web app or API on Schokr by creating a server from one of the generic runtime templates (Node.js, Bun or Python), uploading your code with the file manager, and making your app listen on 0.0.0.0 and the port allocated to your server.

What you need#

• An Schokr account at console.schokr.gg.
• Your app's code, with a dependency file (package.json for Node.js and Bun, requirements.txt for Python).
• Enough of your team's free resource pool for the app. The free package gives each team 6 GB memory, 1.5 CPU cores and 10 GB disk to split across up to 4 servers.

Step by step#

1. In the console, create a new server and pick the Node.js, Bun or Python template. Not sure which? See choosing Node.js, Bun or Python.
2. Give it a sensible amount of memory. A small API is fine with 256 to 512 MB; a Next.js or Django app usually wants 1 GB or more.
3. Open the server's Network section and note the address and port allocated to it.
4. Upload your code in the file manager. Leave out node_modules, virtual environments and build caches; install them on the server instead (see installing dependencies).
5. In your server's Startup settings, set the main file or startup command the template exposes, for example index.js, npm start or app.py.
6. Make sure your app listens on host 0.0.0.0 and on the allocated port. This is the most common reason an app "works locally but not on Schokr". See binding to 0.0.0.0 and the right port.
7. Start the server and watch the console for errors.
8. Visit http://<server-address>:<port> in your browser.

What Schokr provides and what it does not#

For storage, file-based SQLite works well on a single server. Free S3-compatible storage is coming soon.

Framework guides#

• Express, Fastify, Next.js
• Bun.serve, Hono on Bun
• Flask, FastAPI, Django
• Static sites

Still stuck?#

If your app will not start or cannot be reached, read app crashes on start or ask in the Schokr Discord.