Kimai на VPS: встановлення, налаштування та обслуговування

Встановлення Kimai на VPS включає розгортання контейнерів Docker з додатком та базою даних, налаштування реверс-проксі для доступу за доменним ім'ям з підтримкою HTTPS, а також планування регулярних бекапів та оновлень для забезпечення стабільної роботи самохостингу. Це дозволяє отримати повноцінну систему обліку робочого часу, повністю контрольовану вами.

Kimai – це потужний та гнучкий веб-додаток з відкритим вихідним кодом, призначений для обліку робочого часу, відстеження проєктів та управління клієнтами. Він ідеально підходить для фрилансерів, малих та середніх компаній, а також команд, яким потрібен детальний контроль над витраченим часом та виставленням рахунків. Розгорнувши Kimai на власному VPS, ви отримуєте повний контроль над даними, безпекою та продуктивністю, уникаючи обмежень та абонентської плати хмарних сервісів. У цій статті ми детально розберемо, як виконати встановлення Kimai на вашому віртуальному сервері, використовуючи Docker для максимальної простоти та портативності.

Що таке Kimai і навіщо він потрібен на VPS?

Kimai – це сучасне кросплатформне рішення для тайм-трекінгу, яке допомагає ефективно керувати робочим часом. Воно дозволяє записувати години, витрачені на різні проєкти та завдання, генерувати звіти, виставляти рахунки та багато іншого. Головна перевага Kimai у його гнучкості та можливості kimai self-hosted на власному сервері, що забезпечує незалежність від сторонніх постачальників та повний суверенітет над вашими даними.

Ключові можливості та переваги Kimai

Гнучкий тайм-трекінг: Записуйте час вручну або використовуйте вбудований секундомір. Можливість прив'язки часу до клієнтів, проєктів та завдань.
Управління клієнтами та проєктами: Створюйте та керуйте необмеженою кількістю клієнтів та проєктів, призначайте ставки для кожного з них.
Детальні звіти: Генеруйте настроювані звіти за часом, витратами, прибутком, експортуйте їх у різних форматах (CSV, PDF, XLSX).
Виставлення рахунків: Інтегровані функції для створення рахунків на основі облікованого часу.
Багатокористувацька підтримка: Додавайте користувачів з різними ролями та дозволами (адміністратор, менеджер, користувач).
Відкритий вихідний код: Повна прозорість та можливість кастомізації під свої потреби.
API: RESTful API для інтеграції з іншими системами.
Плагіни та розширення: Широкі можливості для розширення функціоналу.

Чому саме VPS для Kimai?

Вибір VPS-хостингу для Kimai на сервері обумовлений кількома важливими факторами. Віртуальний приватний сервер надає ідеальний баланс між вартістю, продуктивністю та контролем. На відміну від звичайного віртуального хостингу, VPS дає вам root-доступ, що дозволяє встановлювати будь-яке необхідне програмне забезпечення (наприклад, Docker), налаштовувати системні параметри та забезпечувати безпеку на потрібному рівні. Це критично важливо для розгортання таких додатків, як Kimai, які вимагають специфічного серверного середовища.

Розміщення kimai vps також гарантує, що ваші дані зберігатимуться у вибраному вами дата-центрі, відповідаючи локальним або корпоративним вимогам конфіденційності. Ви позбавлені ризиків, пов'язаних з політикою використання даних сторонніх сервісів, і можете бути впевнені в їхній безпеці. Крім того, ви отримуєте передбачувану продуктивність, яка не залежить від "сусідів" по серверу, що часто є проблемою на shared-хостингах. Це особливо важливо при масштабуванні, коли кількість користувачів та даних у Kimai зростатиме.

Системні вимоги Kimai: що потрібно знати?

Перш ніж приступати до встановлення Kimai, важливо розуміти, які ресурси знадобляться вашому віртуальному серверу. Kimai відносно невимогливий до ресурсів для невеликих команд, але в міру зростання кількості користувачів та обсягу даних, вимоги зростають. Використання Docker спрощує управління залежностями, але не скасовує необхідності в достатній кількості CPU, RAM та дискового простору.

Мінімальні та рекомендовані конфігурації для Kimai self-hosted

Kimai працює на PHP (версії 8.1 або вище) і вимагає базу даних (MySQL 8.0+, MariaDB 10.5+ або PostgreSQL 13+). Для роботи з Docker вам також знадобиться достатньо місця для образів та контейнерів.

Мінімальні вимоги (до 5 користувачів, невелика кількість проєктів):
- CPU: 1 vCore
- RAM: 1 GB (мінімум 512 MB для Kimai + 512 MB для ОС та Docker)
- Диск: 20 GB NVMe (для ОС, Docker образів та даних)
- Операційна система: Ubuntu 22.04+, Debian 11+
Рекомендовані вимоги (до 20 користувачів, активне використання, звіти):
- CPU: 2 vCores
- RAM: 2 GB
- Диск: 40 GB NVMe
- Операційна система: Ubuntu 22.04+, Debian 11+
Для великих команд (20+ користувачів, інтенсивна робота, API-інтеграції):
- CPU: 4+ vCores
- RAM: 4+ GB
- Диск: 80+ GB NVMe
- Операційна система: Ubuntu 22.04+, Debian 11+

Важливо пам'ятати, що NVMe-диски значно прискорюють роботу бази даних та програми в цілому, тому вони є кращими для kimai self-hosted.

Вибір операційної системи

Для розгортання Kimai на VPS через Docker найбільш оптимальним вибором є дистрибутиви Linux, такі як Ubuntu Server (22.04 LTS і вище) або Debian (11 і вище). Ці ОС добре документовані, мають широку підтримку спільноти та стабільно працюють з Docker. Ubuntu часто обирають за простоту використання та актуальні пакети, Debian – за стабільність та мінімалізм. У цій статті всі команди будуть представлені для систем на базі Debian/Ubuntu.

Шукаєте надійний сервер для ваших проєктів?

VPS від $10/міс та виділені сервери від $9/міс з NVMe, DDoS-захистом та підтримкою 24/7.

Дивитись пропозиції →

Підготовка VPS до встановлення Kimai Docker

Перш ніж приступити до безпосереднього встановлення Kimai, необхідно підготувати ваш віртуальний сервер. Це включає оновлення системи, встановлення Docker та Docker Compose, а також налаштування доменного імені.

Оновлення системи та встановлення Docker/Docker Compose

Підключіться до вашого VPS по SSH. Насамперед оновіть пакети системи, щоб переконатися, що у вас встановлені найсвіжіші версії ПЗ та патчі безпеки:

sudo apt update && sudo apt upgrade -y

Далі встановіть Docker. Рекомендується використовувати офіційний репозиторій Docker для отримання найактуальнішої версії. Виконайте наступні команди:

# Встановлення необхідних пакетів
sudo apt install ca-certificates curl gnupg lsb-release -y

# Додавання GPG-ключа Docker
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# Додавання репозиторію Docker
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Оновлення індексу пакетів та встановлення Docker Engine
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

Перевірте, що Docker встановлено та запущено:

sudo systemctl status docker

Ви побачите статус "active (running)". Додайте вашого користувача до групи docker, щоб не використовувати sudo для кожної команди Docker:

sudo usermod -aG docker $USER
newgrp docker

Тепер ви можете перевірити встановлення Docker, виконавши:

docker run hello-world

І переконатися, що Docker Compose плагін працює:

docker compose version

Налаштування доменного імені та DNS

Для доступу до Kimai на сервері через браузер за красивим ім'ям, а не за IP-адресою, вам знадобиться доменне ім'я. Зареєструйте домен у будь-якого реєстратора та налаштуйте A-запис, що вказує на IP-адресу вашого VPS. Наприклад, якщо ваш домен yourdomain.com, ви можете створити піддомен kimai.yourdomain.com і направити його на IP вашого сервера. Переконайтеся, що DNS-записи оновилися (це може зайняти до кількох годин).

rocket_launch Швидкий вибір

Шукаєте сервер, який просто працює?

Valebyte VPS — NVMe, підтримка 24/7, розгортання за 60 секунд.

Переглянути тарифи VPS arrow_forward

Покрокове встановлення Kimai на VPS з Docker Compose

Тепер, коли ваш VPS готовий, можна приступити до встановлення Kimai Docker. Ми будемо використовувати Docker Compose для визначення та запуску всіх необхідних сервісів (Kimai, база даних).

Створення файлу docker-compose.yml

Створіть директорію для ваших файлів Kimai та перейдіть до неї:

mkdir -p ~/kimai
cd ~/kimai

Створіть файл docker-compose.yml за допомогою текстового редактора (наприклад, nano):

nano docker-compose.yml

Вставте наступний вміст. Це стандартна конфігурація для kimai self-hosted з використанням MySQL/MariaDB. Замініть YOUR_DOMAIN.COM, YOUR_DB_PASSWORD, YOUR_DB_USER, YOUR_DB_NAME на свої значення.

version: '3.8'

services:
  database:
    image: mariadb:10.11
    restart: unless-stopped
    env_file:
      - .env
    volumes:
      - database_data:/var/lib/mysql
    networks:
      - kimai-network

  kimai:
    image: kimai/kimai2:latest
    restart: unless-stopped
    env_file:
      - .env
    depends_on:
      - database
    ports:
      - "8001:8000" # Kimai за замовчуванням слухає порт 8000 всередині контейнера
    networks:
      - kimai-network

volumes:
  database_data:

networks:
  kimai-network:
    driver: bridge

Тепер створіть файл .env у тій самій директорії. Цей файл міститиме змінні оточення для бази даних та Kimai. Замініть YOUR_DB_PASSWORD, YOUR_DB_USER, YOUR_DB_NAME на свої значення. Переконайтеся, що пароль достатньо складний.

nano .env

# Database configuration
DATABASE_URL=mysql://YOUR_DB_USER:YOUR_DB_PASSWORD@database:3306/YOUR_DB_NAME?serverVersion=10.11&charset=utf8mb4

# Kimai configuration
APP_ENV=prod
APP_SECRET=your_secret_key_here # Генеруйте унікальний ключ, наприклад, "openssl rand -base64 32"
TRUSTED_HOSTS=^localhost$,^127\.0\.0\.1$,^YOUR_DOMAIN\.COM$ # Замініть на ваш домен
MAILER_URL=smtp://user:[email protected]:587 # Опціонально: для відправки пошти Kimai

Для APP_SECRET згенеруйте унікальний ключ, наприклад, командою openssl rand -base64 32. TRUSTED_HOSTS повинен включати ваш домен, через який ви будете отримувати доступ до Kimai. Наприклад, якщо ви використовуєте kimai.yourdomain.com, то рядок буде TRUSTED_HOSTS=^localhost$,^127\.0\.0\.1$,^kimai\.yourdomain\.com$. Якщо ви використовуєте кілька доменів або піддоменів, розділіть їх комами.

Запуск Kimai та початкове налаштування

Після створення файлів docker-compose.yml та .env, ви можете запустити Kimai:

docker compose up -d

Опція -d запускає контейнери у фоновому режимі. Docker завантажить необхідні образи (MariaDB та Kimai), створить контейнери та запустить їх. Це може зайняти кілька хвилин при першому запуску.

Перевірте статус запущених контейнерів:

docker compose ps

Ви повинні побачити, що обидва контейнери (kimai-database-1 та kimai-kimai-1) знаходяться у статусі "running".

Тепер Kimai доступний за IP-адресою вашого VPS та портом 8001 (наприклад, http://ВАША_IP_АДРЕСА:8001). Відкрийте цю адресу в браузері. Ви повинні побачити сторінку входу Kimai.

Стандартні облікові дані адміністратора для першого входу:

Ім'я користувача: admin
Пароль: kimai

Обов'язково змініть ці облікові дані відразу після першого входу!

На цьому етапі встановлення Kimai завершено. Однак, для безпечного та зручного доступу за доменним ім'ям з HTTPS, потрібно буде налаштувати реверс-проксі.

Налаштування Reverse Proxy та HTTPS для Kimai на сервері

Прямий доступ до Kimai за IP-адресою та нестандартним портом (8001) не є ідеальним рішенням. Для професійного розгортання Kimai на сервері рекомендується використовувати реверс-проксі (наприклад, Nginx або Caddy) для маршрутизації трафіку до контейнера Kimai та забезпечення HTTPS-шифрування за допомогою Let's Encrypt.

Використання Nginx як Reverse Proxy

Nginx – це високопродуктивний веб-сервер, який чудово підходить для ролі реверс-проксі. Якщо Nginx ще не встановлено на вашому VPS, встановіть його:

sudo apt install nginx -y

Створіть новий конфігураційний файл для вашого домену Kimai:

sudo nano /etc/nginx/sites-available/kimai.conf

Вставте наступну конфігурацію, замінивши kimai.yourdomain.com на ваш фактичний домен:

server {
    listen 80;
    listen [::]:80;
    server_name kimai.yourdomain.com;

    # Перенаправлення HTTP на HTTPS (пізніше буде налаштовано Certbot)
    # return 301 https://$host$request_uri;

    location / {
        proxy_pass http://localhost:8001; # Порт, на якому Kimai слухає всередині контейнера
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_buffering off;
        proxy_request_buffering off;
        proxy_http_version 1.1;
        proxy_read_timeout 900s;
        proxy_send_timeout 900s;
        proxy_connect_timeout 900s;
        proxy_redirect off;
    }
}

Збережіть файл та створіть символічне посилання на нього в sites-enabled:

sudo ln -s /etc/nginx/sites-available/kimai.conf /etc/nginx/sites-enabled/

Перевірте конфігурацію Nginx на помилки та перезапустіть його:

sudo nginx -t
sudo systemctl restart nginx

Тепер ви можете отримати доступ до Kimai за вашим доменним ім'ям (наприклад, http://kimai.yourdomain.com). Наступний крок – забезпечення HTTPS.

Автоматизація HTTPS з Let's Encrypt через Certbot

Let's Encrypt надає безкоштовні SSL/TLS сертифікати, а Certbot автоматизує процес їх отримання та встановлення. Встановіть Certbot та плагін для Nginx:

sudo apt install certbot python3-certbot-nginx -y

Запустіть Certbot для вашого домену. Він автоматично знайде конфігурацію Nginx та налаштує HTTPS:

sudo certbot --nginx -d kimai.yourdomain.com

Certbot поставить кілька запитань (email, згода з умовами). Після успішного виконання він автоматично оновить конфігурацію Nginx, додавши HTTPS та перенаправлення з HTTP на HTTPS. Перевірте, що автоматичне оновлення сертифікатів працює:

sudo systemctl status certbot.timer

Тепер ваш kimai vps доступний за захищеним з'єднанням HTTPS (https://kimai.yourdomain.com).

Альтернатива: Caddy для простоти

Для тих, хто шукає простіше рішення для реверс-проксі та HTTPS, Caddy – відмінний вибір. Caddy автоматично отримує та оновлює сертифікати Let's Encrypt для всіх налаштованих доменів "з коробки".

Встановіть Caddy (інструкції можуть трохи відрізнятися залежно від ОС, але для Debian/Ubuntu зазвичай так):

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy -y

Створіть конфігураційний файл Caddyfile:

sudo nano /etc/caddy/Caddyfile

Замініть вміст на наступний, вказавши ваш домен:

kimai.yourdomain.com {
    reverse_proxy localhost:8001
}

Перезапустіть Caddy:

sudo systemctl restart caddy

Caddy автоматично налаштує HTTPS для вашого домену. Це значно простіше, ніж ручне налаштування Nginx та Certbot, але Nginx пропонує більше можливостей для тонкого налаштування.

Обслуговування Kimai на VPS: бекапи та оновлення

Підтримка Kimai self-hosted у робочому стані вимагає регулярного обслуговування, що включає резервне копіювання даних та своєчасні оновлення. Ці кроки критично важливі для забезпечення стабільності, безпеки та доступності вашого додатка.

Стратегії резервного копіювання для Kimai self-hosted

Резервне копіювання – це найважливіший аспект обслуговування будь-якого сервера. Для Kimai необхідно регулярно бекапити два основні компоненти:

База даних: Містить усі записи про час, клієнтів, проєкти, користувачів та налаштування.
Дані Kimai: Включають конфігураційні файли, завантажені файли (якщо Kimai їх використовує) та інші специфічні дані додатка. У нашому випадку, оскільки Kimai запущений у Docker, основні змінні файли – це ті, що зберігаються в томах.

Для бази даних MariaDB/MySQL, запущеної в Docker, ви можете використовувати команду mysqldump зсередини контейнера:

# Отримати ім'я контейнера бази даних
DB_CONTAINER_NAME=$(docker compose ps -q database)

# Виконати бекап бази даних
docker exec $DB_CONTAINER_NAME sh -c 'exec mysqldump -u YOUR_DB_USER -pYOUR_DB_PASSWORD YOUR_DB_NAME' > ~/kimai_backup/kimai_db_$(date +%F).sql

Замініть YOUR_DB_USER, YOUR_DB_PASSWORD, YOUR_DB_NAME на актуальні значення з вашого файлу .env.

Для бекапу томів Docker, де зберігаються дані Kimai (якщо ви монтували додаткові томи для файлів, крім бази даних):

# Створити архів директорії з даними Kimai, якщо вона містить важливі файли
# Наприклад, якщо ви використовуєте локальний том для налаштувань або завантажених файлів
tar -czvf ~/kimai_backup/kimai_files_$(date +%F).tar.gz ~/kimai/

Рекомендується автоматизувати цей процес за допомогою Cron-завдань. Наприклад, для щоденного бекапу бази даних:

crontab -e

Додайте рядок (замініть шлях до скрипта та облікові дані):

0 3 * * * /bin/bash -c "DB_CONTAINER_NAME=$(docker compose ps -q database) && docker exec $DB_CONTAINER_NAME sh -c 'exec mysqldump -u YOUR_DB_USER -pYOUR_DB_PASSWORD YOUR_DB_NAME' > /path/to/your/kimai_backup/kimai_db_$(date +\%F).sql"

Для більш комплексного підходу до резервного копіювання на VPS, включаючи інкрементальні бекапи та зберігання на віддалених сховищах, розгляньте такі інструменти, як Restic. Це дозволить забезпечити надійне зберігання та швидке відновлення у разі збоїв.

Процес оновлення Kimai Docker

Оновлення Kimai, розгорнутого через Docker Compose, – це відносно простий процес. Регулярні оновлення важливі для отримання нових функцій, виправлень помилок та патчів безпеки.

Перед оновленням завжди робіть бекап бази даних!

# Перейдіть до директорії з docker-compose.yml
cd ~/kimai

# Зупиніть поточні контейнери
docker compose down

# Видаліть старі образи (опціонально, але рекомендується для чистоти)
docker compose rm -f

# Завантажте нові образи та запустіть контейнери
docker compose pull
docker compose up -d

Після запуску нових контейнерів, Kimai автоматично виконає необхідні міграції бази даних при першому запуску нового образу. Якщо ви зіткнулися з проблемами після оновлення, перевірте логи контейнера Kimai:

docker compose logs kimai

Якщо Kimai вимагає будь-яких додаткових команд для міграції бази даних або очищення кешу після оновлення, це зазвичай вказується в офіційній документації Kimai. Наприклад, іноді потрібно виконати:

docker compose exec kimai bin/console doctrine:migrations:migrate --no-interaction
docker compose exec kimai bin/console cache:clear

Однак, для більшості мінорних оновлень, простого docker compose pull && docker compose up -d достатньо.

rocket_launch Швидкий вибір

Шукаєте сервер, який просто працює?

Valebyte VPS — NVMe, підтримка 24/7, розгортання за 60 секунд.

Переглянути тарифи VPS arrow_forward

Вибір VPS-конфігурації для Kimai: реальні сценарії

Вибір правильної конфігурації kimai vps безпосередньо впливає на продуктивність та вартість. Для kimai self-hosted важливо знайти баланс між достатніми ресурсами для комфортної роботи та розумними витратами. Valebyte пропонує різні тарифні плани, які можуть підійти для Kimai під різні сценарії навантаження.

Таблиця порівняння VPS для Kimai під різне навантаження

Нижче представлена таблиця з рекомендаціями щодо VPS-конфігурацій для Kimai, заснованими на кількості користувачів та інтенсивності використання. Ціни є орієнтовними та можуть варіюватися.

Сценарій використання	Користувачі	vCPU	RAM	Диск (NVMe)	Приклад тарифу Valebyte*	Орієнтовна ціна/міс*
Персональний / Тестування	1-3	1	1 GB	20 GB	VPS-1 Core	$5 - $7
Мала команда / Фриланс	4-10	2	2 GB	40 GB	VPS-2 Core	$10 - $15
Середня команда / Активне використання	11-25	2-4	4 GB	80 GB	VPS-4 Core	$20 - $30
Велика команда / Корпоративний	25+	4-8	8+ GB	160+ GB	VPS-8 Core	$40+

*Ціни та назви тарифів є прикладом і можуть відрізнятися від актуальної пропозиції Valebyte. Завжди перевіряйте поточні тарифи на сайті провайдера.

Важливо пам'ятати, що NVMe-диски значно підвищують швидкість роботи бази даних, що критично важливо для продуктивності Kimai, особливо при генерації звітів та великій кількості записів.

Висновки

Встановлення та налаштування Kimai на VPS через Docker Compose — це ефективний спосіб отримати потужну систему обліку робочого часу з повним контролем над даними. Важливо не тільки правильно розгорнути додаток, а й забезпечити його безпеку, регулярне резервне копіювання та своєчасні оновлення. Вибираючи VPS від Valebyte з NVMe-дисками, ви отримаєте надійну основу для стабільної та швидкої роботи вашого Kimai self-hosted рішення, здатного масштабуватися під зростаючі потреби вашої команди.

Готові обрати сервер?

VPS та виділені сервери в 72+ країнах з миттєвою активацією та повним root-доступом.

Почати зараз →