docs

About OpenVK Engine

OpenVK is an attempt to create a simple CMS that cosplays imitates old VK. Code provided here is not stable yet.

VKontakte belongs to Pavel Durov and VK Group.

To be honest, we don’t even know whether it even works. However, this version is maintained and we will be happy to accept your bugreports in our bug-tracker. You should also be able to submit them using ticketing system (you will need an OVK account for this).

When’s the release?

Please use the master branch, as it has the most changes.

Updating the source code is done with this command: git pull --recurse-submodules

Instances

You can see them here.

Can I create my own OpenVK instance?

Yes! And you’re very welcome to. However, OVK makes use of Chandler Application Server. This software requires extensions, that may not be provided by your hosting provider (namely, sodium and yaml. this extensions are available on most of ISPManager hostings). If you want, you can add your instance to the list above so that people can register there.

Installation procedure

1. Install PHP 8.2, web-server, Composer, Node.js, Yarn and Chandler
2. Install commitcaptcha and OpenVK as Chandler extensions like this:

   git clone --recursive https://github.com/openvk/openvk /path/to/chandler/extensions/available/openvk
   git clone https://github.com/openvk/commitcaptcha /path/to/chandler/extensions/available/commitcaptcha
   

3. And enable them:

   ln -s /path/to/chandler/extensions/available/commitcaptcha /path/to/chandler/extensions/enabled/
   ln -s /path/to/chandler/extensions/available/openvk /path/to/chandler/extensions/enabled/
   

4. Import install/init-static-db.sql to same database you installed Chandler to
5. Import install/init-event-db.sql to separate database
6. Copy openvk-example.yml to openvk.yml and change options
7. Run composer install in OpenVK directory
8. Move to Web/static/js and execute yarn install
9. Set openvk as your root app in chandler.yml

Note: If OVK submodules were not downloaded beforehand (i.e. --recursive was not used during cloning), this command must be executed in the openvk folder: git submodule update --init

Once you are done, you can login as a system administrator on the network itself (no registration required):

• Login: admin@localhost.localdomain6
• Password: admin
  • It is recommended to change the password before using the built-in account.

Full example installation instruction for CentOS 8 is also available here.

If my website uses OpenVK, should I publish it’s sources?

You are encouraged to do so. We don’t enforce this though. You can keep your sources to yourself (unless you distribute your OpenVK distro to other people). You also not required to publish source texts of your themepacks and plugins.

Where can I get assistance?

You may reach out to us via:

• Bug-tracker
• Ticketing system
• Telegram comments: On our channel.
• Discussions

!!! attention Bug tracker and Telegram chat are public places. And ticketing system is being served by volunteers. If you need to report something, that shouldn’t be immediately disclosed to general public (for instance, vulnerability report), please use contact us directly at this email: openvk [at] tutanota [dot] com