{"id":7348,"date":"2025-03-07T17:26:29","date_gmt":"2025-03-07T14:26:29","guid":{"rendered":"https:\/\/microimpuls.com\/docs\/smarty\/installation\/%d1%83%d1%81%d1%82%d0%b0%d0%bd%d0%be%d0%b2%d0%ba%d0%b0-smarty-%d0%bd%d0%b0-debian-12"},"modified":"2025-05-29T10:06:11","modified_gmt":"2025-05-29T07:06:11","slug":"installation-smarty-in-debian-12","status":"publish","type":"docs","link":"https:\/\/microimpuls.com\/en\/docs\/smarty\/installation\/installation-smarty-in-debian-12","title":{"rendered":"Installing Smarty on Debian 12"},"content":{"rendered":"

This article describes two options for installing Smarty: on one server and on several servers.<\/p>\n\n\n\n

Install Smarty and Components on a Single Debian 12 Server<\/h2>\n\n\n\n

To work, you will need SSH access to the root server. Installation will be carried out in console mode through terminal commands. If you need to execute a sudo command to obtain root privileges (the server administrator is responsible for installing sudo), then you must execute a command before starting the installation:<\/p>\n\n\n\n

sudo su -<\/pre>\n\n\n\n
Installation of necessary packages<\/h3>\n\n\n\n
You need to establish dependencies through APT:<\/p>\n\n\n\n
apt update<\/code>
apt install git libtiff-dev libjpeg-dev zlib1g-dev libfreetype6-dev liblcms2-dev libwebp-dev python3-tk uwsgi uwsgi-plugin-python3 redis-server build-essential wget pwgen libmariadb-dev nginx python-is-python3 python3-pip python3-setuptools ven3-python-python<\/code><\/pre>\n\n\n\n
Next, you need to download the installation deb package:<\/p>\n\n\n\n
dpkg -i smarty-base*.deb<\/pre>\n\n\n\n
For further work, you will need to install Smarty in a virtual environment and install the necessary libraries for work:<\/p>\n\n\n\n
smarty_manage venv-install
smart_manage requirements<\/pre>\n\n\n\n
\n
Attention!<\/strong> You need to use the Smarty installation package specifically for the Debian Bookworm version, it is located in the bookworm directory. Otherwise, an error may occur when performing further commands undefined symbol: PyFPE_jbuf.<\/code><\/p>\n\n\n\n
To adjust the number of open files in \/etc\/security\/limits.conf, you need to specify at the end of the file:<\/p>\n\n\n\n
*\u00a0\u00a0\u00a0soft nofile\u00a0\u00a0200,000
*\u00a0\u00a0\u00a0hard nofile\u00a0\u00a0200,000<\/code><\/pre>\n\n\n\n
\n
Setting up Redis<\/h3>\n\n\n\n
If you install Smarty and Redis on the same server, add the following settings to \/etc\/redis\/redis.conf:<\/p>\n\n\n\n
stop-writes-on-bgsave-error no
save<\/code><\/pre>\n\n\n\n
\n
Due to the fact that settings for the number of open files are not always accepted (see para. Installation of necessary packages<\/a>This must be written in \/etc\/default\/redis-server by changing the ULIMIT setting <\/strong>on 200000<\/strong>, and in \/lib\/systemd\/system\/redis-server.service by changing the LimitNOFILE value <\/strong>on 200000<\/strong>.<\/p>\n\n\n\n
Reboot Redis:<\/p>\n\n\n\n
sudo systemctl daemon reload
sudo service redis-server restart<\/code><\/pre>\n\n\n\n
Setting up a DBMS for Smarty<\/h3>\n\n\n\n
Attention! <\/strong>The following commands must be written under root rights.<\/p>\n\n\n\n
Smarty supports various databases, such as MySQL, MariaDB or PostgreSQL. For Debian Bookworm, MariaDB should be installed:<\/p>\n\n\n\n
apt install mariadb-server<\/code><\/pre>\n\n\n\n
Create a user to connect Smarty to the database and specify the password in the Smarty settings:<\/p>\n\n\n\n
export DBPASSWORD='pwgen -s 16 1'
echo \"CREATE DATABASE smarty CHARACTER SET = utf8;\" | mysql -u root
echo \"SET default_storage_engine=InnoDB;\" | mysql -u root
echo \"CREATE USER 'smarty'@'localhost' IDENTIFIED BY '$DBPASSWORD';\" | mysql -u root
echo \"GRANT ALL PRIVILEGES ON smarty.* TO 'smarty'@'localhost';\" | mysql -u root
echo \"FLUSH PRIVILEGES;\" | mysql -u root
sed -i -e 's\/PUT DB PASSWORD HERE\/'$DBPASSWORD''\/g' \/etc\/microimpuls\/smarty\/smarty.py<\/code><\/pre>\n\n\n\n
The last command replaces the \"PUT DB PASSWORD HERE\" line with the automatically generated password in the Smarty \/etc\/microimpuls\/smarty\/smarty.py settings file.<\/p>\n\n\n\n
Due to the fact that settings for the number of open files are not always accepted (see para. Installation of necessary packages<\/a>), this must be written in the file \/lib\/systemd\/system\/mariadb.service, changing the value of LimitNOFILE to 200000<\/strong>.<\/p>\n\n\n\n
Preparation of uWSGI application server configuration<\/h3>\n\n\n\n
It is necessary to install a secret key for the operation of the internal protection mechanisms of Smarty:<\/p>\n\n\n\n
export SECRETKEY='pwgen -s 32 1'
sed -i -e 's\/PUT Random SECRET KEY HERE\/'$SECRETKEY''\/g' \/etc\/microimpuls\/smarty\/smarty.py<\/pre>\n\n\n\n
Now you need to activate the Smarty configuration for uWSGI:<\/p>\n\n\n\n
ln -s \/etc\/uwsgi\/apps-available\/smarty.ini \/etc\/uwsgi\/apps-enabled\/smarty.ini<\/code><\/pre>\n\n\n\n
You also need to change the limit of open sockets for optimal uWSGI performance:<\/p>\n\n\n\n
sudo su -c 'echo \"net.core.somaxconn=64000\" > \/etc\/sysctl.conf\"<\/code>
systemctl daemon-reload
sysctl -p<\/code><\/pre>\n\n\n\n
Then configure the correct directory rights for logs and files in Smarty:<\/p>\n\n\n\n
sudo chown -R www-data:www-data \/var\/log\/microimpuls
sudo chown -R www-data:www-data \/usr\/share\/microimpuls<\/code><\/pre>\n\n\n\n
Preparation of the configuration of the nginx Web server<\/h3>\n\n\n\n
You need to activate the Smarty configuration for nginx:<\/p>\n\n\n\n
sudo ln -s \/etc\/nginx\/sites-available\/smarty \/etc\/nginx\/sites-enabled\/smarty<\/code><\/pre>\n\n\n\n
Next, you need to create a directory for cache and logs nginx:<\/p>\n\n\n\n
sudo mkdir -p \/var\/cache\/nginx\/smarty
sudo mkdir -p \/var\/log\/nginx\/microimpuls\/smarty<\/code><\/pre>\n\n\n\n
Set the rights to directories for logs and file downloads in Smarty:<\/p>\n\n\n\n
chown -R www-data:www-data \/usr\/share\/nginx\/html\/microimpuls<\/code><\/pre>\n\n\n\n
Then configure the storage of the nginx cache in tmpfs:<\/p>\n\n\n\n
sudo su -c 'echo tmpfs \/var\/cache\/nginx\/smarty tmpfs defaults,size=1200M 0 >> \/etc\/fstab'
<\/code>systemctl daemon-reload
sudo mount -a<\/code><\/pre>\n\n\n\n
Installation of the licence key<\/h3>\n\n\n\n
At this stage, a license key is required.<\/p>\n\n\n\n
To obtain the license key, you need to use the HW key - the print of the machine on which the Smarty is installed. To get it, you will need to change \/etc\/microimpuls\/smarty\/uwsgi\/smarty.uwsgi setting.prod<\/code> on setting.smarty<\/code>.\u00a0This is followed by a reboot of uWSGI:<\/p>\n\n\n\n
sudo service uwsgi restart<\/code><\/pre>\n\n\n\n
It is necessary to wait about a minute to download the uWSGI and only then complete the work:<\/p>\n\n\n\n
sudo service uwsgi stop<\/code><\/pre>\n\n\n\n
With each uWSGI restart, be sure to make sure that the old uWSGI processes are killed (can be checked by using uWSGI) ps aux | grep uwsgi<\/code> and pay attention to processes with earlier start times, kill them with the help of sudo killall -9 uwsgi<\/code> if necessary), and then in \/var\/log\/uwsgi\/app\/smarty.log find the value of the HW key or use the command:<\/p>\n\n\n\n
sudo cat \/var\/log\/uwsgi\/app\/smarty.log | grep \"HW key\"<\/code><\/pre>\n\n\n\n
The resulting HW key will be as follows (example):<\/p>\n\n\n\n
9eb4a0c2b360c93e32cf2471780cda494705f0a9d026c69fe033d8c8<\/code><\/p>\n\n\n\n
This value must be inserted into the appropriate field in the license generation window in the operator\u2019s personal account (button \u00abGenerate a new license key \u00bb).<\/p>\n\n\n\n
\n
\n
\n
\n
\"\"<\/figure>\n\n\n\n
\"\"<\/figure>\n<\/div>\n<\/div>\n<\/div>\n\n\n\n
\"\"<\/figure>\n<\/div>\n\n\n\n
After that, copy the resulting key with all the license parameters by clicking the button under the column \u00abCopy\u00bb.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
The key and settings must be written in the configuration file \/etc\/microimpuls\/smarty\/smarty.py.<\/p>\n\n\n\n
License generation is called by the button \u201cGenerate a new license key\u201d in the corresponding product in the personal account.<\/p>\n\n\n\n
Copying of the license and all parameters is done using the \u201cCopy\u201d button in the line with the license key.<\/p>\n\n\n\n
After adding the license configuration, you need to check that it is valid. To do this, you need to restart uWSGI and check the logs for no license errors and no Traceback logs due to the lack of additional Python libraries.<\/p>\n\n\n\n
sudo service uwsgi restart<\/code><\/pre>\n\n\n\n
Be sure to make sure old uWSGI processes are killed.<\/p>\n\n\n\n
Log check:<\/p>\n\n\n\n
sudo tail -n 1000 \/var\/log\/uwsgi\/app\/*.log | grep \"*** Starting\" -A 100<\/code><\/pre>\n\n\n\n
The last run log must not contain the \"Key Incorrect\" and \"Traceback\" errors.<\/p>\n\n\n\n
Installation of the OBD scheme<\/h3>\n\n\n\n
You need to install a Smarty database schema using the built-in data migration mechanism:<\/p>\n\n\n\n
sudo smart_manage migrate<\/code><\/pre>\n\n\n\n
Launch of services<\/h3>\n\n\n\n
Command to restart nginx and uWSGI with current settings:<\/p>\n\n\n\n
sudo service nginx restart
sudo service uwsgi restart<\/code><\/pre>\n\n\n\n
Be sure to make sure old uWSGI processes are killed.<\/p>\n\n\n\n
Installation of system settings and configuration<\/h3>\n\n\n\n
To quickly start using Smarty, there is a team that will set system settings and create examples of data: a set of channels, EPG, tariffs, streaming services and other objects necessary for the operation of the IPTV & OTT service. Team:<\/p>\n\n\n\n
sudo smart_manage setup_initial_data<\/code><\/pre>\n\n\n\n
In the future, you can edit them by adding your data.<\/p>\n\n\n\n
Set up regular teams in Crontab<\/h3>\n\n\n\n
For the correct operation of Smarty and updating subscriber data, you need to configure the execution of commands on a schedule in Crontab, for this, you need to add the following lines at the end of the \/etc\/crontab file. Minimum set of regular teams:<\/p>\n\n\n\n
*\/1 * * * * root smarty_manage cache_channel_list --settings=settings.smarty
0 9.18 * * * root smarty_manage epg_import --settings=settings.smarty
0 3 * * * root smarty_manage clean_old_messages --days_count 3 --settings=settings.smarty<\/code><\/pre>\n\n\n\n
The first team updates the cache of TV channels. The second command imports EPG (teleguide) 2 times per day: at 09:00 and 18:00 server time. The third team clears old, undelivered text messages created 3 or more days ago.<\/p>\n\n\n\n
Creating a user and getting started<\/h3>\n\n\n\n
Management of IPTV & OTT service in Smarty is carried out through the Web-control panel. You need to create a user with superadministrator rights to access the control panel.<\/p>\n\n\n\n
This command will display the first 16-character generated password:<\/p>\n\n\n\n
echo 'pwgen -s 16 1'<\/pre>\n\n\n\n
The team to create a superuser for Smarty:<\/p>\n\n\n\n
sudo smart_manage createsuperuser<\/pre>\n<\/div><\/div>\n<\/div><\/div>\n<\/div><\/div>\n\n\n\n
When creating a superadministrator, you must specify the previously generated password.
Attention!<\/strong> Important items to be filled:<\/p>\n\n\n\n