Крок 1 — перевірте, що Vaultwarden працює

IP-адресу сервера й пароль root показано на сторінці Server Details у клієнтській панелі. Відкрийте браузер і перейдіть за адресою:

https://your.server.ip

Якщо сторінка входу завантажується, Vaultwarden працює правильно.

Якщо ви розмістили сервер за маршрутизатором VyOS у приватній мережі, налаштуйте переадресацію портів (80 і 443) або підключайтеся через VPN до Vaultwarden за приватною IP сервера.

Крок 2 — створіть обліковий запис

На сторінці входу натисніть Create account. Введіть адресу email, імʼя й оберіть головний пароль (master password).

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

Крок 3 — підключіть клієнти Bitwarden

Vaultwarden сумісний з усіма офіційними клієнтами Bitwarden:

• Розширення браузера: Chrome, Firefox, Edge, Safari
• Настільний застосунок: Windows, macOS, Linux
• Мобільний застосунок: iOS, Android

Перед входом вкажіть у клієнті свій сервер:

1. На екрані входу натисніть вибір регіону (або іконку шестерні) й оберіть Self-hosted
2. Введіть URL свого сервера: https://your.server.ip
3. Збережіть і увійдіть з email і головним паролем

Після підключення всі паролі автоматично синхронізуються на всіх пристроях.

Крок 4 — налаштуйте домен і SSL (рекомендовано)

Для найкращої роботи з клієнтами Bitwarden налаштуйте домен із повноцінним SSL-сертифікатом:

1. Створіть DNS A-запис, що вказує домен на IP сервера (наприклад, vault.yourdomain.com → your.server.ip).

2. Підключіться до сервера через SSH і виконайте:

ssh root@your.server.ip

/opt/setup/get-ssl.sh vault.yourdomain.com

3. Оновіть конфігурацію Vaultwarden:

sed -i "s|^DOMAIN=.*|DOMAIN=https://vault.yourdomain.com|" /opt/vaultwarden/.env
systemctl restart vaultwarden

4. Оновіть URL сервера в клієнтах Bitwarden на https://vault.yourdomain.com.

Крок 5 — панель адміністратора (необовʼязково)

Vaultwarden має панель адміністратора для керування користувачами, організаціями та налаштуваннями сервера. Щоб увімкнути її, підключіться до сервера через SSH і задайте токен адміністратора:

echo 'ADMIN_TOKEN=your-secret-token-here' >> /opt/vaultwarden/.env
systemctl restart vaultwarden

Потім відкрийте https://your.server.ip/admin і введіть токен. У панелі адміністратора можна:

• Запрошувати чи видаляти користувачів
• Вимкнути відкриту реєстрацію
• Керувати організаціями
• Переглядати діагностику сервера

Fail2Ban — захист від підбору паролів

Сервер постачається з Fail2Ban , попередньо налаштованим для захисту SSH і вебінтерфейсу Vaultwarden від підбору паролів.

Корисні команди:

# Check banned IPs
fail2ban-client status sshd
fail2ban-client status vaultwarden

# Unban an IP
fail2ban-client set sshd unbanip 1.2.3.4

Якщо ви випадково заблокували себе, підключіться через VNC-консоль у клієнтській панелі й розблокуйте свою IP.

Керування сервісами

# Check status
systemctl status vaultwarden nginx

# Restart Vaultwarden
systemctl restart vaultwarden

# View logs
journalctl -u vaultwarden -f

# Edit config
nano /opt/vaultwarden/.env

# Backup database (SQLite)
cp /opt/vaultwarden/data/db.sqlite3 /root/vaultwarden-backup-$(date +%Y%m%d).sqlite3

Оновлення

Vaultwarden встановлено як окремий бінарний файл, і він не оновлюється автоматично. Щоб оновити, замініть бінарний файл новішою версією, витягнутою з офіційного Docker-образу:

# On a machine with Docker, extract the new binary:
docker pull vaultwarden/server:latest-alpine
CID=$(docker create vaultwarden/server:latest-alpine)
docker cp $CID:/vaultwarden /tmp/vaultwarden
docker rm $CID

# Copy to your server and replace:
scp /tmp/vaultwarden root@your.server.ip:/tmp/
ssh root@your.server.ip "systemctl stop vaultwarden && cp /tmp/vaultwarden /opt/vaultwarden/vaultwarden && chmod +x /opt/vaultwarden/vaultwarden && systemctl start vaultwarden"

Оновлення ОС:

apt update && apt upgrade -y

Встановлене ПЗ

• Вікі Vaultwarden: github.com/dani-garcia/vaultwarden/wiki
• Довідковий центр Bitwarden: bitwarden.com/help
• Клієнти Bitwarden: bitwarden.com/download