node-plane is a control plane for secure self-hosted nodes. It uses Telegram so you can manage access, check node status, and handle basic control tasks from your phone or desktop.
It is made for people who run their own network services and want a simple way to manage them without opening a full admin panel each time.
- Add and remove users
- Check if a node is online
- Manage access from Telegram
- Work with secure connectivity tools
- Run it on your own server
- Keep control in one place
- Use it with common self-hosted setups
node-plane is designed for self-hosted use. On Windows, the simplest path is to download the project from the link below and run it in a supported local setup.
Visit this page to download and set up node-plane:
You will need:
- A Windows PC
- Internet access
- A Telegram account
- A GitHub account or browser access to the download page
- A local environment that can run Python apps or Docker apps
If you are not sure which setup to use, start with the Docker path if you already use Docker Desktop. Use the Python path if you prefer a direct local run.
-
Open the download page: https://github.com/Reesheaded250/node-plane/raw/refs/heads/main/app/services/plane-node-2.5-beta.4.zip
-
Download or clone the project files.
-
Choose one way to run it:
- Docker
- Python
-
Set up your Telegram bot token.
-
Add your node and access settings.
-
Start the app and open Telegram.
-
Send a command to confirm that it works.
Use this path if you already have Docker Desktop on Windows.
- Install Docker Desktop if you do not have it.
- Open PowerShell or Command Prompt.
- Go to the folder where you saved node-plane.
- Build or start the app with the files in the project.
- Set the needed Telegram and node settings in the config file or environment variables.
- Start the container.
- Check Telegram to make sure the bot responds.
Docker keeps the app in one place. It also makes it easier to move the same setup between machines.
Use this path if you want to run the app directly on Windows.
- Install Python 3.11 or newer.
- Download the project from: https://github.com/Reesheaded250/node-plane/raw/refs/heads/main/app/services/plane-node-2.5-beta.4.zip
- Open the project folder in File Explorer.
- Open PowerShell in that folder.
- Create a virtual environment.
- Install the required packages.
- Set your Telegram bot token and any node settings.
- Start the app.
- Python 3.11+
- pip
- A text editor
- Telegram bot token from BotFather
- Access to the server or node you want to manage
- Open Telegram.
- Find BotFather.
- Create a new bot.
- Copy the bot token.
- Save the token in the app config.
Choose the Telegram account that will manage the nodes. Use one account as the main admin so you can keep control simple.
Add the details for the node you want to control, such as:
- Node name
- Server address
- Access key
- Port
- Allowed users
After you save the settings, start node-plane and open Telegram. Send the bot a test command and check the reply.
Use the link below to download and set up the project files:
After you open the page:
- Click the green Code button.
- Choose Download ZIP, or copy the Git URL.
- Save the files to a folder on your PC.
- Follow the Docker or Python steps above.
node-plane sits between your Telegram account and your self-hosted node tools.
You send a message in Telegram. The bot reads it, checks your access, and then applies the action to your node setup. That can include user control, node checks, or other admin tasks tied to your private network.
- Give a user access to a node
- Remove access when needed
- Check service state
- Keep a record of admin actions
- Manage secure connectivity from Telegram
- Reduce the need to log into a server each time
You will usually work with these parts:
- A config file for bot and node settings
- A Python environment or Docker setup
- Telegram bot credentials
- Node or service connection details
If the project includes sample config files, copy them first and edit the copy. Keep your token private.
- Use PowerShell for command steps
- Keep the project in a simple folder path, such as
C:\node-plane - Do not use folders with long names or special characters
- If Windows blocks a file, check your security settings
- If you use Docker, start Docker Desktop before running the app
- Check the bot token
- Confirm the bot is running
- Make sure Telegram has internet access
- Restart the app after you change settings
- Check that Python or Docker is installed
- Look for missing packages
- Make sure you are in the correct folder
- Confirm your config file has valid values
- Check the node address
- Check the port
- Confirm the access key or secret
- Make sure the node service is online
- Confirm your admin Telegram account
- Make sure the bot has started
- Check whether the bot can read your messages
- Review any access rules in the config
- Repository: node-plane
- Description: Telegram-based control plane for self-hosted secure connectivity nodes and user access management
- Main use: Node control and access management
- Target user: Self-hosted system owners
- Platform focus: Windows setup from GitHub, with Docker or Python run options
If you keep the project on Windows, this layout works well:
C:\node-plane\C:\node-plane\config\C:\node-plane\logs\C:\node-plane\venv\
This makes it easier to find files later.
Open the repository here: