Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

MystNodes Manager (bot.py)

A Python-based interactive CLI tool for managing Mysterium Nodes on Linux (Debian/Ubuntu) systems. This script provides an easy-to-use menu-driven interface to handle installation, configuration, and monitoring of Mysterium Node services.

Features

  • Install Node: Choose between native APT installation or automatic script installation.
  • Check Node Status: View the current status of the Mysterium Node service.
  • Service Management: Start, stop, or restart the Mysterium Node service.
  • Log Viewer: View live logs or save logs to a file.
  • Configuration Viewer: Display active Mysterium Node configuration.
  • Edit SERVICE_OPTS: Modify service options (e.g., WireGuard ports) with validation.
  • Update Node: Update the node to the latest version.
  • Install Development Version: Install snapshot/development versions from the dev repository.
  • Color-Coded Output: Uses ANSI colors for better readability (green for success, red for errors).
  • User Confirmation: Prompts for confirmation before executing critical actions.

Requirements

  • Operating System: Linux (Debian/Ubuntu). The script checks for Linux and warns if run on other platforms.
  • Python Version: 3.6 or higher.
  • Privileges: Must be run with sudo (or as administrator on Windows, though Windows is not fully supported).
  • Dependencies: Standard Python libraries only (os, subprocess, sys, shutil, time, platform).

Installation

  1. Clone or download the repository:

    git clone https://github.com/dani12po/MYST.git
    cd MYST
    
  2. Ensure the script has execute permissions (optional, since it's run with python3):

    chmod +x bot.py
    

Usage

Run the script with sudo privileges:

sudo python3 bot.py

Main Menu Options

  1. Install Node: Select installation method (Native APT or Automatic Script).
  2. Check Node Status: Displays the service status using systemctl.
  3. Start / Stop / Restart Node: Manage the service lifecycle.
  4. View Logs: Choose to view live logs or save to a file (node.logs).
  5. View Active Configuration: Shows current config via myst config show.
  6. Edit SERVICE_OPTS: Edit /etc/default/mysterium-node file with validation (must end with 'wireguard').
  7. Update Node: Updates to the latest version via APT.
  8. Install Development/Snapshot Version: Installs from the dev PPA, allowing version selection.
  9. Exit: Quits the script.

Example Workflow

  • After installation, check the status to ensure the service is running.
  • Use the log viewer to monitor activity.
  • Edit SERVICE_OPTS if you need to change ports or other options.
  • Restart the service after configuration changes.

Notes

  • The script performs automatic checks and confirmations for safety.
  • All commands requiring elevated privileges use sudo.
  • On non-Linux systems, the script will warn but attempt to run (commands may fail).
  • Logs saved to file are stored in the current directory as node.logs.

Troubleshooting

  • Permission Errors: Ensure you're running with sudo.
  • Command Failures: Verify that Mysterium Node packages are available in your repositories.
  • Platform Warnings: This tool is optimized for Linux; Windows support is limited.

Contributing

Feel free to submit issues or pull requests on the GitHub repository.

License

This project is open-source. See the repository for license details.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages