Skip to content

StrangeRanger/nadeko-manager-scripts

Repository files navigation

nadeko-manager-scripts

Project Tracker Style Guide Codacy Badge

This is the unofficial installer and manager for NadekoBot v5 on Linux.

Getting Started

Downloading linuxAIO

The only script that needs to be downloaded to your system is m-bridge.bash. To do this, execute the following set of commands:

curl -O https://raw.githubusercontent.com/StrangeRanger/nadeko-manager-scripts/main/m-bridge.bash
chmod +x m-bridge.bash

Usage

To use the manager, execute the following command: ./m-bridge.bash

If the following command was successfully executed, a menu with the following options (or something very similar) should be displayed:

1. Download NadekoBot
2. Run NadekoBot in the background
3. Run NadekoBot in the background with auto restart
4. Stop NadekoBot
5. Display 'nadeko.service' logs in follow mode
6. Install prerequisites
7. Back up important files
8. Exit

Officially Supported Distributions

The following is a list of all the Linux distributions that the Manager has been tested and are officially support on:

Distro/OS Version Number End of Life EOL Information
Ubuntu 24.04
22.04
April 25, 2029
April 01, 2027
endoflife.date
ubuntu.com
Linux Mint 22
21
April 30, 2029
April 30, 2027
endoflife.date
linuxmint.com
Debian 12 June 10, 2026 endoflife.date
wiki.debian.org
Fedora 41
40
November 19, 2025
May 28, 2025
endoflife.date
docs.fedoraproject.org
fedorapeople.org
Alma Linux 9
8
May 31, 2032
March 01, 2029
endoflife.date
wiki.almalinux.org
Rocky Linux 9
8
May 31, 2032
May 31, 2029
endoflife.date
wiki.rockylinux.org
OpenSuse Leap 15.6 December 31, 2025 endoflife.date
en.opensuse.org
OpenSuse Tumbleweed Rolling N/A N/A
Arch Linux Rolling N/A N/A

Testing

I've utilized Docker images to test the Manager on various Linux distributions. This is done via the Dockerfile and script located in the Distro Testing directory.

There are two methods to test the Manager scripts:

  1. Pulling Pre-built Images from Docker Hub: You can pull the pre-built images for each distribution using the appropriate tags. For detailed instructions on how to run and interact with these images, refer to the Docker Hub repository.

  2. Building Images Locally: If you prefer to build the images on your machine, you can execute the provided script that builds all of the images locally. Simply run:

    cd "Distro Testing"
    ./build-docker-images.bash

    This script will construct the Docker images for all supported Linux distributions. Once the build process completes, you can run the images using the same instructions as for the pre-built versions.

For more information on how to interact with and run the images, see the instructions on the Docker Hub repository.