Discord: PoiXson
yum/dnf: yum.poixson.com
What is Configer.IO
ConfigerIO is a modular server management system and web control panel. It's light weight, automatic, and installs in moments. Drop in your configer.json file, install only what services you need, and everything is up and running already. Easy as can be.
Still in development
The web control panel is an optional package you may install on each of your servers, or on a central management server to remotely manage other servers.
How it works
As each service starts, it only takes milliseconds for the configer-gen tool to read the configer.json file and generate the config files for that service. Just-in-time configs.
Currently Supported
Supported Operating Systems:
- RHEL/CentOS/Rocky/Alma 8 and 9
- Fedora 36/37
Current State
Many supported services are now fully functional, and many more in the works.
- DNS hosting with Bind - Fully functional, however serial numbers in zone files are not yet incrementing. This will be finished soon.
- Web hosting with Nginx and HAProxy - Fully functional, as well as the php-fpm service. SSL/TLS for https is handled by let's encrypt and the configer-certs service.
- EMail hosting with Postfix and Dovecot - This is a very complicated thing. This is about half finished, more to come soon. Receiving emails into mailboxes is partly functional. IMAP and sending emails are unfinished.
- Minecraft server hosting - This is partly working, as a system service and contained in a screen session. Setup and management isn't yet finished.
note: Some services may not enable or start automatically. This is a known bug and will be fixed soon. You may enable and start these services yourself for now:
systemctl enable nginx-something
systemctl start nginx-something
Setup
It's recommended to prepare your configer.json configuration file before installing the packages. If the file is ready and in place, the system will come online and fully functional after packages have installed.
An example file can be found here: https://configer.io/configer.json
The ConfigerIO system will search for the configer.json file in these locations:
- /configer.json
- /etc/configer.json
- /var/configer.json
- /home/configer.json
The first found of the above list takes priority. It should be owned and readable by root. The configer-gen tool will generate config files for each service on-demand, just before each start. If you make a change to the configer.json file, simply restart the affected services to apply the changes.
wget -O /configer.json https://configer.io/configer.json
nano /configer.json
Installing
It's recommended to prepare your configer.json configuration file before installing the packages.
There are a few ways to install ConfigerIO. What suites you best?
- Automatic install script
- Wizard with menus is available using the install.sh --wizard flag
- Install from packages
- Manual install from source - possible, but good luck. This hasn't yet been documented.
Automatic install
The install.sh script can be used to automatically install the required packages and begin managing services. This is great for use with Docker.
The latest install script can be found here: https://configer.io/install.sh
wget -O configer-install.sh https://configer.io/install.sh
sh configer-install.sh --auto
note: This feature is currently unfinished. You may expect this in the coming months.
Wizard install
The install wizard and menus can be used by adding the --wizard flag with the above script.
wget -O configer-install.sh https://configer.io/install.sh
sh configer-install.sh --wizard
Manual Install from Packages
You may look inside the above script to see exactly what repositories and packages are needed.
- You will first need the pxn repo
- If you are using CentOS/Rocky/Alma/Red Hat, you will need the EPEL repo.
- If you are using PHP for web hosting, or using the web control panel, you will need the Remi repo.
- If Nginx is not available by default on your distro of choice, you may need the nginx repo.
- You're finished. Your services are now configured and online.
dnf install https://yum.poixson.com/latest.rpm
dnf install epel-release (and/or) remi-release (if rhel/rocky/alma)
dnf install nginx-release (only if needed)
dnf update
dnf install configerio
dnf install configer-<service-packages..>