Хостването на Vikunja на Managed VPS означава да пазите задачите и проектите на вашия екип на своя собствена машина, която нашите екипи поддържат актуална и наблюдават денем и нощем. Vikunja е свободен софтуер с лиценз AGPL-3.0. Това ръководство следва официалната му документация: изборът на база данни, инсталирането с Docker Compose, публичният адрес и тайният ключ, акаунтите, HTTPS, собствените настройки на Vikunja, имейлите, резервните копия и обновленията.
Автор: Simon Vasconcelos Lee
Публикувано на 19 ноември 2026 г.Време за четене: 13 минути
vikunja/vikunja:2.8.0 и PostgreSQL, с порт 3456, публикуван на 127.0.0.1, зад обратен прокси с HTTPS.service.publicurl, HTTPS адресът на вашата инстанция, и service.secret, който подписва сесиите.files, преди всяко обновяване; миграциите на базата данни се изпълняват сами при стартиране.Vikunja е самостоятелно хостван мениджър на задачи и проекти с отворен код, който хранилището му описва като „мениджърът на задачи, който наистина притежавате“. API, написан на Go, и уеб интерфейсът се доставят в един-единствен изпълним файл или в един-единствен Docker образ: има само едно нещо за инсталиране.
Vikunja е публикуван с лиценза GNU AGPL версия 3 или по-нова, с изключение на папката desktop/ в хранилището му, настолното приложение, която е с лиценз GPL версия 3 или по-нова. Можете да го използвате, включително във фирма, за екипа си, както и за клиентите си, без да купувате лиценз. Остава цената на сървъра, на който работи.
Член 13 добавя условие, присъщо на AGPL: ако променяте програмата, вашата версия трябва ясно да предложи на всеки, който взаимодейства с нея от разстояние, през мрежата, възможността да получи безплатно изходния ѝ код. Ако разпространявате копия, прилагат се и задълженията на лиценза за споделяне на кода. Пускането на Vikunja без промяна не задейства този член.
Това ръководство инсталира това издание с отворен код, което документацията описва като напълно функционално само по себе си. Vikunja Pro, незадължителен лиценз, добавя администраторски панел, отчитане на работното време и журнали за одит за организациите.
Vikunja работи със SQLite, PostgreSQL, MySQL или MariaDB. Документацията не дава числа за паметта или процесора; тя насочва избора на база данни според броя на потребителите:
| База данни | Какво казва документацията | Версия, тествана в CI |
|---|---|---|
| SQLite | Вградена в изпълнимия файл и в Docker образа, нищо за инсталиране. При повече от няколко потребители документацията препоръчва MySQL или PostgreSQL. | Вградената |
| PostgreSQL | Базата данни в Docker примерите на документацията. От 2.8.0 търсенето пренебрегва диакритичните знаци с разширението unaccent. | 18 |
| MySQL, MariaDB | Поне MySQL 8.0, тъй като 5.7 не се поддържа. За нелатински знаци базата данни трябва да използва utf8mb4. | MySQL 8, MariaDB 12 |
Документацията препоръчва версия на базата данни, която все още се поддържа. Redis може да служи като кеш, но тя отбелязва, че вероятно няма да ви трябва, докато инстанцията има само няколко потребители: това ръководство минава без него.
Използваното дисково пространство зависи главно от прикачените файлове и фоновете на проектите, съхранявани в папката files, най-много 20 MB на файл по подразбиране. На Managed VPS ни разкажете за екипа си, броя на потребителите му и колко разчита на прикачени файлове и ще ви препоръчаме подходящия размер.
Документацията инсталира Vikunja и PostgreSQL с Docker Compose. На сървър с инсталиран Docker създайте папка и първо генерирайте тайния ключ на инстанцията, случайна стойност, която ще поставите във файла:
openssl rand -hex 32
После поставете в папката този docker-compose.yml, взет от примера с PostgreSQL в документацията. Заменете tasks.example.com с името на домейна си, paste-your-secret-here със стойността, която генерирахте, и changeme със силна парола, една и съща на двете места:
services:
vikunja:
image: vikunja/vikunja:2.8.0
environment:
VIKUNJA_SERVICE_PUBLICURL: https://tasks.example.com/
VIKUNJA_SERVICE_SECRET: paste-your-secret-here
VIKUNJA_SERVICE_IPEXTRACTIONMETHOD: xff
VIKUNJA_DATABASE_TYPE: postgres
VIKUNJA_DATABASE_HOST: db
VIKUNJA_DATABASE_USER: vikunja
VIKUNJA_DATABASE_PASSWORD: changeme
VIKUNJA_DATABASE_DATABASE: vikunja
ports:
- "127.0.0.1:3456:3456"
volumes:
- ./files:/app/vikunja/files
depends_on:
db:
condition: service_healthy
restart: unless-stopped
db:
image: postgres:18
environment:
POSTGRES_USER: vikunja
POSTGRES_PASSWORD: changeme
volumes:
- ./db:/var/lib/postgresql
restart: unless-stopped
healthcheck:
test: ["CMD-SHELL", "pg_isready -h localhost -U $$POSTGRES_USER"]
interval: 30s
start_period: 15s
start_interval: 5s
Vikunja работи с потребител 1000: създайте папката files и му я предоставете преди първото стартиране, както иска документацията, после стартирайте услугите:
mkdir files
sudo chown 1000 files
docker compose up -d
docker compose logs vikunja
При първото стартиране Vikunja създава базата си данни и изпълнява всичките си миграции. Редът http server started on [::]:3456 в журналите означава, че е готов, а командата curl http://127.0.0.1:3456/api/v1/info, изпълнена на сървъра, връща версията му и публичните му настройки.
127.0.0.1: тук се отклоняваме от примерите в документацията, които публикуват порта на всички адреси. Нейният списък за подсилване на сигурността изисква само обратният прокси да може да достига Vikunja: тогава интерфейсът се отваря през него, по HTTPS.VIKUNJA_SERVICE_PUBLICURL: HTTPS адресът, който потребителите ви отварят, с наклонената черта в края. Vikunja го използва, за да изгражда връзките си, например в имейлите, и като разрешен CORS източник, който е включен по подразбиране: следователно тази настройка е задължителна. Грешен адрес, например без порт, се проявява като грешка „unauthorized“ при създаването на първия акаунт.VIKUNJA_SERVICE_SECRET подписва токените на сесиите. Ако е празен, той се генерира случайно при всяко стартиране и тогава всяко рестартиране изписва всички потребители.2.8.0 фиксира версията, както препоръчва документацията, така че обновленията стават, когато вие решите. latest следва последната стабилна версия, а unstable версиите в разработка.files и db пазят прикачените файлове и данните на PostgreSQL на сървъра: те са това, което архивирате.scratch. docker exec към обвивка не работи, а променливите PUID и PGID на други образи нямат ефект върху него. Грешките се четат с docker compose logs vikunja.За няколко потребители документацията предлага SQLite: премахнете услугата db, блока depends_on и променливите VIKUNJA_DATABASE_* и монтирайте папка на /db, където образът вече съхранява vikunja.db. Създайте я и я предоставете на потребител 1000, както files:
volumes:
- ./files:/app/vikunja/files
- ./db:/db
От версия 2.4.0 Vikunja публикува хранилище с пакети за Debian и Ubuntu, за amd64, arm64 и armhf, подписано с неговия GPG ключ:
curl -fsSL https://dl.vikunja.io/repos/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/vikunja.gpg
echo "deb [signed-by=/usr/share/keyrings/vikunja.gpg] https://dl.vikunja.io/repos/apt stable main" | sudo tee /etc/apt/sources.list.d/vikunja.list
sudo apt update && sudo apt install vikunja
Пакетът инсталира Vikunja в /opt/vikunja, по подразбиране със SQLite, и услуга systemd, която е включена, но още не е стартирана. Той записва и случаен таен ключ в раздел service на /etc/vikunja/config.yml: допълнете същия раздел, после стартирайте услугата.
service:
secret: "the value written by the package"
publicurl: "https://tasks.example.com/"
interface: "127.0.0.1:3456"
ipextractionmethod: "xff"
sudo systemctl start vikunja
Vikunja не създава акаунт по подразбиране. След като HTTPS е на място, отворете https://tasks.example.com/ и се регистрирайте: това е първият ви акаунт. Регистрацията е отворена по подразбиране за всеки, който стигне до адреса; след като акаунтите на екипа ви съществуват, документацията предлага да я затворите. Добавете този ред към променливите на услугата vikunja, после изпълнете отново docker compose up -d:
VIKUNJA_SERVICE_ENABLEREGISTRATION: "false"
Следващите акаунти се управляват от командния ред. Тъй като образът няма обвивка, извиквате директно неговия изпълним файл:
docker compose exec vikunja /app/vikunja/vikunja user create -u marie -e marie@example.com
docker compose exec vikunja /app/vikunja/vikunja user list
docker compose exec vikunja /app/vikunja/vikunja user reset-password 2 --direct
user create пита за паролата, когато флагът -p не я дава, което я държи извън историята на терминала ви.user reset-password изпраща по имейл връзка за нулиране или заменя паролата директно с --direct, по идентификатора, който показва user list.user change-status деактивира или активира отново акаунт, с --disable или --enable.doctor проверява конфигурацията, публичния адрес, тайния ключ, базата данни, правото на запис в files и, когато е включен, SMTP сървъра.VIKUNJA_SERVICE_TIMEZONE е GMT по подразбиране и очаква име от базата данни tz, например Europe/Paris, никога отместване спрямо UTC. Тя служи като часова зона по подразбиране на потребителите и следователно определя часа на напомнянията им.Vikunja предоставя HTTP в явен вид. Документацията поставя HTTPS на обратен прокси, така че паролите и токените никога да не пътуват некриптирани: той слуша на портове 80 и 443, получава сертификата и препраща към Vikunja на 127.0.0.1:3456.
Зад прокси Vikunja по подразбиране вижда адреса на проксито при всяка заявка: тогава журналите и ограниченията на честотата засягат всички наведнъж. Настройката VIKUNJA_SERVICE_IPEXTRACTIONMETHOD: xff, която вече е във файла на Compose, го кара да чете заглавката X-Forwarded-For. Той се доверява на тази заглавка само при заявки, идващи от loopback адреси и адреси от частни мрежи, включително мрежата на Docker: с порта, публикуван на 127.0.0.1, само вашето прокси стига дотам.
Ето Caddyfile от документацията. Caddy сам получава сертификат Let’s Encrypt за даденото име, предава заглавката X-Forwarded-For и пропуска връзките WebSocket:
tasks.example.com {
reverse_proxy 127.0.0.1:3456
}
Блокът от документацията се свежда до ред proxy_pass и размер на качваните файлове. Този блок надгражда върху него с две добавки: заглавката X-Forwarded-For, която Vikunja чете, и заглавките за WebSocket. Интерфейсът на версия 2.8.0 отваря връзка WebSocket на /api/v2/ws за обновленията си на живо; когато тя не успее, известията му преминават към проверка на всеки 10 секунди. Първо добавете този блок map в раздела http на /etc/nginx/nginx.conf:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
После този блок за сайта, на порт 80, за да остави на Certbot да постави HTTPS:
server {
listen 80;
listen [::]:80;
server_name tasks.example.com;
location / {
proxy_pass http://127.0.0.1:3456;
client_max_body_size 20M;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
}
}
sudo nginx -t
sudo certbot --nginx
client_max_body_size 20M съответства на максималния размер на файл във Vikunja, 20 MB по подразбиране. Ако го увеличите с VIKUNJA_FILES_MAXSIZE, документацията иска да увеличите и този ред.
Почти всеки ключ от файла config.yml има своя променлива на средата: service.enablecaldav става VIKUNJA_SERVICE_ENABLECALDAV. Когато една опция е зададена и на двете места, променливата има предимство. Списъкът за подсилване на сигурността в документацията преглежда функциите, които да изключите, ако не ви трябват:
| Ключ | По подразбиране | Изключете го, за да |
|---|---|---|
service.enablelinksharing | true | Забраните споделянето на проекти чрез публични връзки |
service.enablecaldav | true | Премахнете крайната точка CalDAV, която приема HTTP basic auth |
webhooks.enabled | true | Попречите на Vikunja да изпраща заявки към адреси, избрани от потребителите |
service.enabletaskattachments | true | Забраните качването на файлове към задачите |
service.enableuserdeletion | true | Попречите на потребителите да изтриват собствените си акаунти |
plugins.enabled | false | Вече е изключено: дръжте кода на трети страни извън Vikunja |
От 2.8.0 търсенето пренебрегва диакритичните знаци в PostgreSQL, когато разширението unaccent е активно: „cafe“ намира и „café“. Официалният образ на PostgreSQL го съдържа; активирайте го в базата данни на Vikunja, после рестартирайте Vikunja. Тогава журналът показва unaccent extension detected, search is accent-insensitive.
docker compose exec db psql -U vikunja -d vikunja -c 'CREATE EXTENSION IF NOT EXISTS unaccent;'
docker compose restart vikunja
Всеки потребител импортира задачи от раздела „Import“ в настройките си и може там също да експортира всичките си данни като zip архив. Импортирането от файл, архив на Vikunja, CSV, TickTick и WeKan, както и импортирането от инстанция на Planka, са винаги достъпни. Todoist, Trello и Microsoft To Do минават през OAuth: те са изключени по подразбиране и се включват в раздела migration на конфигурацията, с данните за достъп на приложението, създадено при всяка услуга. Пренасочването на OAuth става в браузъра: инстанцията не е нужно да е достъпна за тези услуги, но service.publicurl трябва да е правилен.
CalDAV синхронизира задачите с приложенията ви, с данните за връзка от раздела CalDAV в настройките. Документацията представя тази интеграция като алфа версия, която работи добре с някои клиенти: изпробвайте своя, преди да я направите инструмент на целия екип. На iPhone и iPad всеки проект става списък в приложението „Напомняния“. Акаунт с двуфакторно удостоверяване се свързва със специален токен за CalDAV.
Vikunja изпраща имейли за напомнянията за задачи, потвърждението на нов акаунт и нулирането на пароли. Изпращането е изключено по подразбиране: тогава акаунтите са активни веднага след създаването си, а нулирането на парола по имейл не е възможно. След като изпращането е включено, всеки нов локален акаунт потвърждава адреса си преди употреба.
От VPS на Simafri настройте SMTP сървър с удостоверяване, на порт 587 или 465: този на вашата услуга за изпращане или на вашия доставчик на имейл. Добавете тези променливи към услугата vikunja:
VIKUNJA_MAILER_ENABLED: "true"
VIKUNJA_MAILER_HOST: smtp.example.com
VIKUNJA_MAILER_PORT: 587
VIKUNJA_MAILER_USERNAME: tasks@example.com
VIKUNJA_MAILER_PASSWORD: your-smtp-password
VIKUNJA_MAILER_FROMEMAIL: tasks@example.com
VIKUNJA_MAILER_FORCESSL: "true", което налага TLS от началото на връзката и отказва некриптираните връзки.plain по подразбиране, login или cram-md5 с VIKUNJA_MAILER_AUTHTYPE, според сървъра ви.Изпълнете отново docker compose up -d, после изпратете тестово съобщение. Командата проверява връзката със SMTP командата NOOP, която някои минималистични релета не поддържат: предпочетете пълноценен SMTP сървър.
docker compose exec vikunja /app/vikunja/vikunja testmail you@example.com
Документацията брои две части за архивиране, заедно: базата данни и папката с прикачените файлове. От 2.8.0 изтритите задачи и проекти първо прекарват 30 дни в кошчето; след като този срок изтече или кошчето бъде изпразнено, само резервно копие може да ги върне.
| Елемент | Какво пази | Как да го копирате |
|---|---|---|
| Базата данни PostgreSQL | Акаунти, проекти, задачи, коментари и настройки | pg_dump, без да спирате Vikunja |
files | Прикачени файлове, аватари и фонове на проекти | Копие на папката |
Със SQLite, db/vikunja.db | Цялата база данни | Копие на файла, при спрян Vikunja |
docker-compose.yml | Тайният ключ, публичният адрес и паролите | Пази се отделно, като тайна |
docker compose exec -T db pg_dump -U vikunja vikunja > vikunja-$(date +%F).sql
tar -czf vikunja-files-$(date +%F).tar.gz files
Документацията иска криптирани резервни копия, пазени извън сървъра, и редовно тествани възстановявания: на отделна инстанция влезте и отворете задача с прикачен файл. Поставени на диска на сървъра, тези архиви влизат и в нощните му резервни копия.
Командата vikunja dump събира конфигурацията, базата данни и всички файлове в zip архив, а vikunja restore го зарежда обратно. Архивът съдържа конфигурационния файл и всяка променлива VIKUNJA_* в явен вид: криптирайте го и го защитавайте като самата база данни.
На нова инсталация, със същия docker-compose.yml, заредете експорта в още празната база данни преди първото стартиране на Vikunja, после върнете папката files на мястото ѝ:
docker compose up -d db
docker compose exec -T db psql -U vikunja vikunja < vikunja-2026-11-19.sql
tar -xzf vikunja-files-2026-11-19.tar.gz
docker compose up -d
Vikunja изпълнява сам миграциите на базата си данни, когато стартира нова версия. Затова документацията иска резервно копие преди всяко обновяване, за да можете да се върнете към предишното състояние, и прочит на бележките към версията, които посочват евентуалните ръчни стъпки.
files.docker-compose.yml, например от 2.8.0 към следващата версия.docker compose pull
docker compose up -d
С пакета за Debian sudo apt update && sudo apt upgrade заменя изпълнимия файл и рестартира услугата. Преминаването от стабилна версия към версиите unstable работи, но документацията не съветва връщането обратно: по-добре изчакайте следващата стабилна версия.
Корекциите на сигурността се публикуват като GitHub security advisories и се обявяват в бележките към версиите. Версия 2.8.0 от 5 ноември 2026 г. поправя деветнадесет от тях, а съобщението за нея моли да обновите възможно най-скоро. За да бъдете известявани, следете версиите в хранилището в GitHub или се абонирайте за RSS емисията на списъка с промени.
Самостоятелното хостване изисква да поддържате сървъра освен приложението. На Managed VPS нашите екипи поемат сървъра и следят проактивно вашата инстанция; Vikunja остава ваш софтуер, с неговите настройки, вашите проекти и вашите задачи.
| Тема | Нашите екипи | Вие |
|---|---|---|
| Сървърът | Обновления на системата и на сигурността, включително намеси на сървъра | Моментът, който пасва на вашата дейност |
| Наблюдението | Сървър, следен денонощно, 7 дни в седмицата, с намеса, без да се чака обаждането ви | Четенето на журналите на вашата инстанция |
| Vikunja | Проактивно проследяване: грешки, забавяния и дисково пространство се откриват, препоръчва се корекция | Инсталирането, обновяванията и настройките му, които прилагате вие или вашият AI асистент |
| Акаунтите и проектите | Сървърът, който ги носи, наблюдаван и архивиран | Акаунтите на екипа ви, регистрацията, споделянията и правата |
| Имейлите | Сървър, който достига вашия SMTP сървър на порт 587 или 465 | Вашата услуга за изпращане и данните ѝ за достъп |
| Резервните копия | Всяка нощ, криптирани и пазени извън машината; възстановяването е включено | Вашите експорти на базата данни и на папката files, и заявката за възстановяване, когато ви потрябва |
| Миграцията | Сегашният ви сървър е мигриран, безплатно | Моментът на превключването |
Ако предпочитате нашите екипи да се намесват в самото приложение, тази услуга се фактурира на час или на фиксирана цена, с оферта, съобщена преди намесата.
С Managed VPS от Simafri нашите екипи поддържат актуален сървъра на вашата инстанция на Vikunja, наблюдават го денем и нощем и се намесват, без да чакат обаждането ви; те следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие или вашият AI асистент. Резервните копия се криптират всяка нощ и се пазят извън машината, възстановяването им е включено, а миграцията от сегашния ви сървър е безплатна.
Да. Vikunja е с лиценз AGPL-3.0: можете да го използвате във фирма, без да купувате лиценз. Ако го промените, вашите отдалечени потребители трябва да могат да получат изходния код на вашата версия. Остава цената на сървъра, на който работи.
SQLite, вградена в образа, е достатъчна за няколко потребители. При повече документацията препоръчва PostgreSQL или MySQL. PostgreSQL е базата данни в нейните Docker примери, а от 2.8.0 търсенето в нея пренебрегва диакритичните знаци с разширението unaccent.
Създайте docker-compose.yml с образите vikunja/vikunja:2.8.0 и postgres:18, порт 3456, публикуван на 127.0.0.1, папка files, предоставена на потребител 1000, публичния адрес и тайния ключ, после изпълнете docker compose up -d. След това поставете обратен прокси с HTTPS пред порт 3456.
service.publicurl е HTTPS адресът на вашата инстанция: Vikunja изгражда от него връзките си и своя CORS източник, оттук и грешката unauthorized, когато е грешен. service.secret подписва сесиите; ако е празен, той се сменя при всяко стартиране и изписва всички потребители.
Vikunja няма акаунт по подразбиране: регистрирайте се на своята инстанция. После затворете регистрацията, като зададете VIKUNJA_SERVICE_ENABLEREGISTRATION на false, и създавайте следващите акаунти с командата vikunja user create, изпълнена в контейнера.
Включете изпращането с VIKUNJA_MAILER_ENABLED, после въведете хоста, порт 587 или 465, потребителското име, паролата и адреса на подателя на вашия SMTP сървър. Без имейли акаунтите са активни веднага след създаването си, а паролите се нулират от командния ред.
Архивирайте заедно базата данни, с pg_dump за PostgreSQL, и папката files с прикачените файлове. Пазете копията криптирани и извън сървъра, правете копие преди всяко обновяване и редовно тествайте възстановяването им.
Managed VPS покрива сървъра: система, сигурност, наблюдение и резервни копия. Нашите екипи следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие. Намеса в самото приложение се фактурира на час или на фиксирана цена.
Simafri
Да поговорим за Вашия проект
Кажете ни с няколко думи от какво имате нужда: отговаряме Ви бързо.
Благодарим! Вашето запитване е изпратено. Ще се свържем с вас скоро.
Предпочитате имейл? Пишете ни на support@simafri.com.