Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lunaisnotaboy/qtbooru
An imageboard forked from Danbooru
https://github.com/lunaisnotaboy/qtbooru
hacktoberfest ruby ruby-on-rails
Last synced: about 2 months ago
JSON representation
An imageboard forked from Danbooru
- Host: GitHub
- URL: https://github.com/lunaisnotaboy/qtbooru
- Owner: lunaisnotaboy
- License: other
- Created: 2022-09-24T21:32:20.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2022-10-18T12:10:03.000Z (about 2 years ago)
- Last Synced: 2024-10-12T19:41:39.396Z (3 months ago)
- Topics: hacktoberfest, ruby, ruby-on-rails
- Language: Ruby
- Homepage: https://guya.ml
- Size: 83.9 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
[](https://codecov.io/gh/danbooru/danbooru) [](https://discord.gg/eSVKkUF)
## Quickstart
Run this to start a basic Danbooru instance:
```sh
curl -sSL https://raw.githubusercontent.com/danbooru/danbooru/master/bin/danbooru | sh
```
This will install [Docker Compose](https://docs.docker.com/compose/) and use it
to start Danbooru. When it's done, Danbooru will be running at http://localhost:3000.
Alternatively, if you already have Docker Compose installed, you can just do:
```sh
wget https://raw.githubusercontent.com/danbooru/danbooru/master/docker-compose.yaml
docker-compose up
```
## Manual Installation
Follow the [INSTALL.debian](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](https://github.com/danbooru/danbooru/wiki/Ubuntu-Installation-Help-Guide)
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](https://github.com/danbooru/iqdb).
### Archive Service
In order to access pool and post histories you will need to install and
configure the [Archives service](https://github.com/danbooru/archives).
### Reportbooru Service
The following features are delegated to the [Reportbooru service](https://github.com/danbooru/reportbooru):
* Post views
* Missed searches report
* Popular searches report
### Recommender Service
Post recommendations require the [Recommender service](https://github.com/danbooru/recommender).