# Amnezia VPN Manager 1.1.4

Инструкция по установке и запуску через Docker на Linux amd64.

## Установка

Для запуска нужны Docker Engine и Docker Compose.

Сохраните `compose.yaml` и `.env.example` с этой страницы в отдельную папку
или распакуйте в неё готовый комплект Docker Compose. Все следующие команды
выполняйте в этой папке.

Скопируйте `.env.example` в `.env`:

```bash
cp .env.example .env
```

Откройте `.env` и задайте собственный длинный случайный пароль
`AVM_AUTH_PASSWORD`. Пустой пароль не позволяет запустить приложение.
При необходимости измените имя пользователя `AVM_AUTH_USERNAME`.

Запустите приложение и проверьте его состояние:

```bash
docker compose up -d
docker compose ps
```

## Открытие приложения

Откройте <http://127.0.0.1:5097> и войдите с данными из `.env`.

Если приложение установлено на VPS, выполните на Вашем компьютере:

```bash
ssh -N -L 5097:127.0.0.1:5097 USER@SERVER
```

Замените `USER` и `SERVER` на имя пользователя и адрес Вашего сервера.
Пока SSH-туннель работает, приложение доступно в браузере Вашего компьютера
по тому же адресу <http://127.0.0.1:5097>.

Для постоянного доступа через домен настройте обратный прокси с HTTPS.
По умолчанию приложение доступно только на компьютере, где оно запущено.

## Сохранение данных

Данные приложения хранятся в томе `inventory_data`, ключи шифрования —
в `keyring_data`. Сохраняйте оба тома при обновлении и резервном копировании.
Обычная команда `docker compose down` сохраняет их. Флаг `-v` удаляет данные.

После установки добавьте Ваши серверы, SSH-ключи, VPN-профили и пользователей
в приложении.