evazion/danbooru repository overview

⁠Quickstart

Clone this repository and run bin/danbooru to start a basic Danbooru instance:

git clone https://github.com/danbooru/danbooru
cd danbooru
./bin/danbooru

This will install Docker Compose⁠ and use it to start Danbooru. This will take several minutes and produce lots of output. When it's done, Danbooru will be running at http://localhost⁠.

Alternatively, if you already have Docker Compose installed, you can just do:

docker-compose -f config/docker/docker-compose.simple.yaml up

⁠Manual Installation

Follow the INSTALL.debian⁠ script to install Danbooru.

The INSTALL.debian script is written for Debian, but can be adapted for other distributions. Danbooru has been successfully installed on Debian, Ubuntu, Fedora, Arch, and OS X. It is recommended that you use an Ubuntu-based system since Ubuntu is what is used in development and production.

See here⁠ for a guide on how set up Danbooru inside a virtual machine.

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.

In production, Danbooru uses PostgreSQL 10.18, but any release later than this should work.

⁠Troubleshooting

If your setup is not working, here are the steps I usually recommend to people:

1. 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.

2. Test the Rails database connection by using bin/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.

3. Test Nginx to make sure it's working correctly. You may need to debug your Nginx configuration file.

4. Check all log files.

⁠Services

Danboou depends on a couple of cloud services and several microservices to implement certain features.

⁠Amazon Web Services

The following features require an Amazon AWS account:

• Pool history
• Post history

⁠Google APIs

The following features require a Google Cloud account:

• BigQuery database export

⁠IQDB Service

IQDB integration is delegated to the IQDB service⁠.

⁠Archive Service

In order to access pool and post histories you will need to install and configure the Archives service⁠.

⁠Reportbooru Service

The following features are delegated to the Reportbooru service⁠:

• Post views
• Missed searches report
• Popular searches report

⁠Recommender Service

Post recommendations require the Recommender service⁠.