|Classes of Aleksey Nemiro||>||PHP Small Server Administrator||>||README.md||>||Download|
?# SmallServerAdmin (SSA)
This control panel for small Debian and Ubuntu servers.
The interaction with a server is performed via SSH.
The panel has a modular structure. One can easily create new modules or enhance existing ones.
SmallServerAdmin is licensed under the Apache License Version 2.0.
See also Third-Party License.
Server requirements to manage (administrable server):
The panel can be located on any server.
Server requirements for the control panel:
_NOTE: Earlier versions have not been tested._
_NOTE: For Windows required PHP v5.5._
Installation & Configuration
Server Configuration (administrable server)
If SmallServerAdmin will be located on the managed (administrable) server, it is recommended to use HTAN to automatic install SmallServerAdmin:
To manually install and configure the server, use the following instructions below.
All commands to the server are performed through sudo. On the server, you must install and configure sudo.
For Debian only, istall sudo:
The interaction with the server will be carried out via SSH. Usually on a server must already be installed OpenSSH package, but if it is not, you need to install OpenSSH.
To obtain information about the system used sysstat, which is also necessary to install.
And also recommended etckeeper to install:
The best practice is to create a single user on whose behalf will be server management.
For example, add ssa user:
_NOTE: You can use any name instead of ssa._
_ATTENTION: Remember user password. It is required for the Panel Configuration._
Add the user to the sudo group:
And restart sudo:
If the connection via SSH is limited to narrow the list of users, add the created user in the list of allowed.
Add user name to the
_NOTE: List of users separated by spaces. For example:
This is the minimum configuration that must be done.
If you have connection problems, try restarting the server.
General (default) panel settings contained in the ssh.config.php file.
The parameters are stored in the global variable
In addition, each server can have its own settings, which are located in the /servers folder.
The panel has a modular design. Each module has its own set of parameters. For details see the README file of a specific module.
_NOTE: If you use automatic installation with HTAN, then change the settings of SSH is not need._
To operate the panel, you must configure the SSH connection settings.
By first opening the panel in a browser, you will be redirected to the servers management page where you can add and configure a new server. If it does not, open or create the /servers/default.php file and specify the connection settings to the server.
If the connection settings are incorrect, the panel can not connect to the server.
All commands are executed via sudo.
If the value
If you are the only one user on the server, you can disable the password.
For this set the
And also allow the execution of commands without entering a password:
_NOTE: At the same time, the password will still be used to connect to the server._
_WARNING: If the server has other users, then for security reasons it is not recommended to disable the requirement of password._
In the parameter
The absence of modules in the list does not restrict access to them.
Modules in the menu will be displayed in the order in which they are specified in the list.
In the file ssa.config.php specified the default list of modules that will be used for all servers, who have not their own list of modules.
Some modules have widgets that can be displayed on the main page.
Widget settings are located in the root element -
Each widget must contain the required parameter
In the optional parameter
In addition, the widget may comprise any other individual parameters. For more information, see the README file of a specific module.