- Latest version of VirtualBox and the VM Extension Pack (download)
- Latest version of Vagrant (download)
- Download and install the prerequisites
- Open Command Prompt/Terminal and run the following commands:
vagrant plugin install vagrant-hostmanager vagrant plugin install vagrant-bindfs vagrant plugin install vagrant-vbguest
- Download and extract the repo
cd
into the repo using Command Prompt/Terminal- Run the following command:
vagrant up
- Once vagrant exists with an error, execute
vagrant up
again (Workaround to install the linux headers required by the guest additions) - This would be a good time to rewatch your favorite TV series installment, cook & have breakfast/lunch/dinner, walk the dog, clean your room, etc.
By the time you get back the install will surely have completed.1 - To confirm the installation worked, open the web browser of your choice and enter
http://e621.lc
into the address bar and see if the website loads correctly.
1 If the install did not finish by the time an activity is complete please select another activity to avoid crippling boredom.
In case the VM doesn't start with the error VT-x not available
and the error description WHvCapabilityCodeHypervisorPresent is FALSE!
the the following solution should resolve the issue:
This error usually occours, when the Hyper-V
or the Windows Hypervisor Platform
features are activated.
To deactivate these features, press the windows key and enter Turn Windows features on or off
, here you can deactivate both features by unchecking their respective checkboxes.
Don't forget to restart the computer after deactivating the features.
It is recommended that you install Danbooru on a Debian-based system since most of the required packages are available on APT. Danbooru has been successfully installed on Fedora, CentOS, FreeBSD, and OS X. The INSTALL.debian install script is straightforward and should be simple to adapt for other platforms.
For best performance, you will need at least 256MB of RAM for PostgreSQL and Rails. The memory requirement will grow as your database gets bigger.
On production Danbooru uses PostgreSQL 9.4, but any 9.x release should work.
Use your operating system's package management system whenever possible. This will simplify the process of installing init scripts, which will not always happen when compiling from source.
These instructions won't work for everyone. If your setup is not working, here are the steps I usually recommend to people:
-
Test the database. Make sure you can connect to it using psql. Make sure the tables exist. If this fails, you need to work on correctly installing PostgreSQL, importing the initial schema, and running the migrations.
-
Test the Rails database connection by using rails console. Run Post.count to make sure Rails can connect to the database. If this fails, you need to make sure your Danbooru configuration files are correct.
-
Test Nginx to make sure it's working correctly. You may need to debug your Nginx configuration file.
-
Check all log files.
Danbooru employs numerous external services to delegate some functionality.
For development purposes, you can just run mocked version of these
services. They're available in scrtip/mock_services
and can be started
automatically using Foreman and the provided Procfile.
In order to enable the following features, you will need an AWS SQS account:
- Pool versions
- Post versions
- IQDB
- Saved searches
- Related tags
The following features requires a Google API account:
- Bulk revert
- Post versions report
IQDB integration is delegated to the IQDBS service.
In order to access versioned data for pools and posts you will need to install and configure the Archives service.
The following features are delegated to the Reportbooru service:
- Related tags
- Missed searches report
- Popular searches report
- Favorite searches
- Upload trend graphs
Post recommendations require the Recommender service.
There's optional support for cropped thumbnails. This relies on installing
libvips-8.6
or higher and setting Danbooru.config.enable_image_cropping
to true.