Getting started

#What is Netrun?

Netrun is a cloud platform that runs your code online. You upload a project, answer a couple of questions and get a working link. Servers, Docker, nginx, the domain and SSL are all on us.

#How do I publish a project?

Upload your code or connect GitHub, answer a couple of questions about the project and get a link. Everything else — the build, the launch and HTTPS — is on us.

#How do I upload a project?

Two ways: upload an archive with your code (ZIP, RAR, 7z, tar), or import a repository from GitHub, including a private one. From there Netrun deploys everything for you.

#What kinds of projects can I host?

Websites, Telegram bots, scripts and small services — from a static page to a backend with a database.

#Do I need my own server or VPS?

No. Netrun deploys your project on its own servers. There is no VPS to rent, no systemd or nginx to configure and no certificates to renew — all of that runs for you.

#Do I need to know how to work with Docker?

No. Netrun detects which language your project uses and builds it for you. If you already have a Dockerfile or docker-compose, we support them, but you do not need to write them specially.

#Do I need git if I have never used it?

No. You can simply upload an archive with your code — neither git nor a terminal is needed. And if GitHub is more convenient, you can import the project from there, including a private repository.

#How is Netrun different from a VPS, Heroku or Railway?

A VPS is an empty server: the setup (Docker, nginx, SSL, updates) and the upkeep are on you. Netrun does this for you — upload your code and get a working link, with no server setup. Unlike foreign platforms such as Heroku and Railway, Netrun accepts payment by Russian card and via SBP and offers support in Russian.

#How is Netrun different from Vercel and Render?

Vercel is built for frontends and serverless functions — not every backend or Telegram bot will run there. Render is closer in purpose, but it is a foreign service that needs a foreign card. Netrun runs any code — a website, an API or a bot — accepts payment by Russian card and via SBP and offers support in Russian.

#How do I put a website online?

Upload your site code as a ZIP archive or from GitHub — Netrun builds it and gives you a working link with HTTPS. A static site (HTML, CSS, JS), a React app or a Python site all work. There is no domain to buy and no server or certificates to set up.

Plans and payment

#How much does it cost, and is there a free plan?

There is a free plan for one project. A website on it lives as long as you like: it sleeps when idle and wakes up on request. A bot or a background script runs for 3 hours — enough to see that it builds and replies — and after that it needs the Pro plan. The Pro plan is paid for once, for the term you choose — a month, three months or a year: you pay and use it until the paid term ends. Current prices are shown on the plans page in your account.

#Is this free hosting?

For websites — yes. On the free plan a website lives as long as you like: it sleeps when nobody visits and wakes up by itself when someone opens it, and you pay nothing for a server. A bot or a background script can be started and tried for free for 3 hours — they are busy all the time and cannot sleep, so after that they need the Pro plan. If you need several projects, you can buy places on top of your plan — each place gives you one more project.

#What is different about the Pro plan?

On the Pro plan your project runs around the clock: a website does not sleep and responds instantly, with no pause to wake up, while a bot or a background script keeps running with no time limit. On top of that, Pro gives more memory, CPU and disk space, and a Pro website can use your own domains — as many as you need, each with HTTPS.

#What is the Max plan and who is it for?

Max is for projects that have outgrown Pro: more memory, CPU and disk. You pick the size at checkout, and there are three: Max S — 4 GB of memory · 2 vCPU · 10 GB of disk, Max M — 4 GB of memory · 4 vCPU · 15 GB of disk, Max L — 8 GB of memory · 4 vCPU · 20 GB of disk. Everything else is as on Pro: the project runs around the clock, your own domains with HTTPS, 24-hour monitoring. Websites on Max also get the Analytics tab: how many people came, where from and which pages they viewed. You can add up to seven places to the plan — each gives you one more project of the same size. Current prices are shown on the plans page in your account.

#Can I move from Pro to Max, or change the Max size, in the middle of a paid term?

Yes, any day. You pick the new plan and a term just like a regular purchase: the new term starts today, and the unused days of your previous plan and places are credited towards the payment as a separate line — you lose nothing. Places move to the new size together with the plan. Moving to a cheaper plan mid-term is not possible — only when you renew, in the last week of the paid term.

#How do I pay for a plan or a place for a project?

Choose what you need in your account and pay for it — with a Russian card, via SBP or with cryptocurrency. Prices are shown in dollars, but your card is charged the ruble amount at the current rate — no need to exchange currency yourself. The service switches on right after payment and works until the paid term ends. If you added funds to a balance earlier, that money is not lost: it comes off your next payment as a discount.

#What do I pay for?

You pay for a plan — Pro or Max. If you need several projects, you add places to it — they last until your plan ends and renew together with it, in one purchase. A payment only happens when you confirm it yourself. The free plan costs nothing.

#How many projects can I keep?

Every plan includes one project. On Pro you can add up to two places, on Max — up to seven; each place gives you one more project of the same size as the plan. The free plan has no places: a second project means Pro.

#What are places for projects and how do they work?

A place adds one more project to your paid plan — Pro or Max — of the same size as the plan itself; it is about how many projects you have, not how they run. A place lasts until your plan ends: take it together with the plan and it is paid for the same term; add it mid-term and you only pay for the remaining days. It renews together with the plan, in one purchase, and is never sold for longer than the plan. The free plan has no places: a second project means Pro.

#What happens when a place for a project runs out?

A place ends together with your plan, and we remind you about the end of the term by email in advance — one email for the plan and its places. You can renew everything in one purchase, and at checkout you may keep fewer places than before: the checkout tells you which project would stop. If there is no payment, the project above your plan limit stops: its code and data stay where they are, and paying brings everything back. After that you have 2 days to pay — if you do not, the project is deleted along with its data. None of this happens silently: an email comes in advance, at the moment the app stops, and once more a day before deletion, and your account shows the deadline and what to do.

#Will I be charged automatically when the paid term ends?

No. Every payment is a one-off: we do not keep your card on file and we never charge you ourselves. When the paid term is coming to an end we remind you by email, and whether to pay again is up to you. There is nothing to cancel: if you do nothing, the service simply ends on its day.

#What happens when the paid term of my plan ends?

Your projects go back to the free plan: a website starts sleeping again when nobody visits, and a bot or a background script stops. Nothing is deleted — the code, the settings and the data stay where they are, and once you pay everything comes back as it was. We remind you by email before the term ends, and your account shows the day everything is paid up to.

#Do I lose paid days if I pay ahead of time?

No. If you pay while the current term is still running, the new term is added on top of it — paid days are not lost. So you can pay ahead of time instead of waiting for the last day.

#What currency are prices and payments in?

Prices are shown in US dollars. You can still pay however is convenient: by a Russian card or via SBP — your card is charged the ruble amount at the current rate, with nothing to convert yourself. We also accept cryptocurrency. Current prices are shown on the plans page in your account.

#Can I pay with a Russian card or via SBP?

Yes. You can pay for a plan or a place for a project with a Russian card or via SBP, even though prices are shown in dollars. Your card is charged the ruble amount at the current rate — no foreign card and no currency exchange on your side. Besides card and SBP we also accept cryptocurrency.

Features and limits

#Which languages and technologies are supported?

Python, Node.js, Go, Rust, Ruby, PHP, Java, .NET, Deno, Bun, Elixir, static sites and bash scripts. You can bring your own Dockerfile or docker-compose, but more often the stack is detected from your code automatically.

#Can I run a Python project — Django, Flask or FastAPI?

Yes. Put your dependencies in requirements.txt — Netrun detects Python and builds the project for you. Django, Flask and FastAPI are supported; the app should listen on the port from the environment variable, and keys and database access are set as secrets rather than in the code.

#What about React, Vue, Next.js, Nuxt, Svelte or Astro?

Yes, all of them work. Upload the source code with your package.json — you do not need to build the project yourself or include the built output, the build happens on our side. If your framework can produce both static pages and a server build, either works: in server mode the app should listen on the port from the environment variable. One important detail: values baked into the built front-end are visible to any visitor, so keep real keys on the server side.

#Is there a way to run something on a schedule?

There is no separate schedule setting in the dashboard. Scheduling is done inside the application itself: the script runs continuously and decides when to act — with a loop and a pause, or with a scheduling library. A project like that counts as a background script: it does not sleep, so on the free plan it runs for 3 hours, and continuous operation needs the Pro plan.

#Can I run Selenium or Playwright?

You can, but a browser is not part of the automatic build — you install it yourself with your own Dockerfile next to the code, and we build the project from it. A browser needs noticeably more resources than a plain script. If the data comes back from an ordinary request, a scraper without a browser is simpler and more reliable.

#Does the project update itself when GitHub changes?

No — publishing a new version is your call: open the project and update it from GitHub, or upload a new archive. That way a stray commit does not go straight to your users. The link stays the same after an update, and data in persistent storage is kept.

#Can I publish straight from Cursor, Claude Code or ChatGPT?

Yes. The dashboard has an “MCP” section: create an access key there and connect it to Cursor, Claude Code, Codex or any other AI editor — with one button or one command. After that you just tell the agent “publish this bot to Netrun”: it uploads the code folder, asks you for the token if the code needs one, waits for the build and gives you the link. “I fixed the greeting — update it” ships a new version, “why is the bot silent?” shows the logs. The agent cannot pay, renew or delete projects — that stays in the dashboard.

#Can I connect my own domain?

Yes, on the Pro plan, and not just one: you can connect as many of your own domains to a website as you need. Open the “Domains” tab on the project page, enter the domain you bought from a registrar, and add the DNS record shown in the hint — every next domain is added the same way. Once the domains are ready, press “Check”: Netrun checks them all at once and issues a separate HTTPS certificate for each, so a hiccup with one domain does not hold up the others. The site opens at any of your addresses, and the Netrun link stays as a backup. If you connect a whole domain (for example myshop.com), you can add one more record so the site also opens with www. This is for websites — a bot or a background script does not need a domain.

#Can I host a Telegram bot?

Yes. Upload the bot code and provide the token from BotFather (Telegram itself gives it to you when you create the bot) — Netrun starts the bot, and no VPS or manual setup is needed. On the free plan the bot runs for 3 hours so you can check everything; to keep it running around the clock, switch to the Pro plan.

#Can I host a Discord bot?

Yes. Upload the bot code (for example, in discord.py or discord.js) and add the token from the Discord Developer Portal as a secret — Netrun starts the bot, and no VPS or manual setup is needed. On the free plan the bot runs for 3 hours so you can check everything; to keep it running around the clock, switch to the Pro plan.

#Where can I host a Telegram bot for free?

On Netrun you can start a bot for free and try it out: on the free plan it runs for 3 hours — no VPS, no server bills and no setup. Upload the code, provide the token from BotFather, and the bot starts in a couple of minutes. To keep the bot running around the clock you need the Pro plan: a bot is busy all the time, so what lives on Netrun for free with no time limit is websites, not bots.

#Can I run several services at once?

Yes. With docker-compose one project can bring up a whole set of services — an app together with a database, a cache and a background worker, say. We do not cap how many: the real ceiling is the memory and CPU of your plan, which are shared between the services of the project.

#Where do I set tokens and other secret values?

Every project has a Secrets tab where you set the values from your code — for example the token from BotFather. We store them encrypted: you can see the variable names, but the values are shown to no one, including you.

#Do I need to buy a domain and set up HTTPS?

No. Netrun gives your project a public address with HTTPS right away — the link with the padlock works out of the box. There is no domain to buy and no certificates to fuss with, it is all already included.

#Is there a limit on project size?

Yes, uploads have a size limit. Larger projects may need a paid plan, and the current limit is shown in your account when you upload.

How your project runs

#Why does my website sometimes sleep?

On the free plan, websites sleep after being idle and wake up in a couple of seconds on the first request. On the Pro plan your project runs without sleeping.

#How do I know my app is doing fine?

The Monitoring tab shows what is happening with your app right now: how many requests are coming in, how fast it replies, and whether any replies were errors — and below that, processor, memory and disk load. Everything refreshes every minute. The Pro plan adds the whole day: whether the app ran without interruptions, which hour it went down and how fast it replied. Bots and background scripts get no incoming requests — nobody comes to them by link — so for them we only show uptime.

#Can I see how many people visit my website and where they come from?

Yes, on the Max plan a website gets the Analytics tab. It shows how many people came and how many pages they viewed, where they came from — search, Telegram, social networks, AI assistants or your own tagged link — which pages they view and which they land on, which countries and devices they use, what time of day and which days of the week they come. It also shows whether Yandex, Google and ChatGPT visited the site, how many times forms were sent and files downloaded, and which addresses led people to a missing page. Nothing to install on the site: we count visits ourselves from requests to the site, without cookies and without storing visitors' addresses. History is kept for 90 days. Bots and background scripts have no visitors, so they don't have this tab.

#What happens to my bot after 3 hours on the free plan?

The bot switches off, but your code, settings and secrets stay where they are — we delete nothing. Shortly before it switches off we send you a warning. The three hours only count while the bot is actually running: while it is stopped, still building or crashed with an error, the clock stands still — you can fix the code and start it again without losing time. Switch to the Pro plan, and the bot starts again from the same place and runs around the clock. A new bot uploaded after that is built too, but it will not start: free time is counted per account, not per project.

#Do bots and background scripts sleep?

No, only websites sleep: a website wakes up by itself when someone opens it. A bot or a background script has nothing to wake it — nobody comes to them by link, they work on their own. That is why on the free plan they run for 3 hours, and after that a bot needs the Pro plan to keep running around the clock.

#How do I update the code of a project that is already published?

Open the project and upload a new version or update it from GitHub. The link stays the same, and your data is kept as long as it lives in persistent storage — the /data folder or a volume from your compose file.

#Is my data kept when I update the code?

Yes, as long as your data lives in persistent storage. For a regular project that is the /data folder: anything your app saves there stays in place when you update the code or restart, and you can browse and download the files on the "Data" tab. If you described the services yourself in docker-compose, persistent storage means the named volumes from your file, and such a project has no /data folder. Files written outside persistent storage are created from scratch on the next deploy. Your project link stays the same either way.

#What happens if my app crashes?

We watch over projects and restart them if they fail. The status and the logs appear in your account straight away, and we send a notification only if the app has not come back within an hour: short interruptions are not worth disturbing you over.

#Where can I see the logs and status of my project?

The project page shows the status, the logs and the event history — together they show what is happening with the project right now. The log view also reaches further back: scroll up and earlier lines load on their own.

#My project will not open — what should I do?

Open the project page and check its status and logs. If you cannot figure it out, email us.

#How do I delete a project?

Open the project and choose delete. The project and all of its data will be removed with no way to restore them.

Account and security

#How do I sign in without a password?

Enter your email — we send a short sign-in code to it. There is no password to come up with.

#Can I sign in with Google?

Yes. The sign-in page has sign-in with Google — the account is linked to your email.

#Can I create a second account?

One person, one account: signing up a second time from the same device will not go through. Free time is counted per account, so a new email address does not reset it — and a bot that has already used up its free time will not start for free on a new account either. If you need another account for another project, add a place instead — it gives you one more project in the same dashboard. And if sign-up fails even though you have no account, write to us and we will sort it out.

#Are my tokens and secrets safe?

Yes. Tokens, access keys and values from your code are stored encrypted and are never shown in plain text.