Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/danbooru/danbooru
A taggable image board written in Rails.
https://github.com/danbooru/danbooru
anime booru danbooru imageboard rails ruby
Last synced: 6 days ago
JSON representation
A taggable image board written in Rails.
- Host: GitHub
- URL: https://github.com/danbooru/danbooru
- Owner: danbooru
- License: other
- Created: 2010-02-04T19:59:27.000Z (almost 15 years ago)
- Default Branch: master
- Last Pushed: 2024-10-28T13:48:06.000Z (14 days ago)
- Last Synced: 2024-10-29T14:15:13.363Z (13 days ago)
- Topics: anime, booru, danbooru, imageboard, rails, ruby
- Language: Ruby
- Homepage:
- Size: 68.6 MB
- Stars: 2,266
- Watchers: 74
- Forks: 417
- Open Issues: 394
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
[
](https://codespaces.new/danbooru/danbooru?quickstart=1) [](https://discord.gg/danbooru) [](https://codecov.io/gh/danbooru/danbooru)
## Quickstart
### Using Github Codespaces
To launch a Danbooru instance in your browser:
1. [Create a Github account](https://github.com/signup).
2. Click [Open in Github Codespaces](https://codespaces.new/danbooru/danbooru?quickstart=1).
3. Click the `Create new codespace` button.
4. Wait a few minutes for it to launch.
When it's done, you'll have a new Danbooru instance with a full development environment running in your browser. This way you can try out Danbooru without installing anything on your computer.
See the [Codespaces section](https://github.com/danbooru/danbooru/wiki/Docker-Guide#user-content-running-in-github-codespaces) in the [Docker Guide](https://github.com/danbooru/danbooru/wiki/Docker-Guide) to learn more.
### Using Docker
Run this to start a Danbooru instance:
```sh
sh -c "$(curl -sSL https://raw.githubusercontent.com/danbooru/danbooru/master/bin/setup)"
```
This will install [Docker Compose](https://docs.docker.com/compose/) and start Danbooru. When it's done, Danbooru will be running at http://localhost:3000.
Alternatively, if you already have Docker Compose installed, you can do:
```sh
git clone http://github.com/danbooru/danbooru
cd danbooru
touch .env.local config/danbooru_local_config.rb
sudo docker compose up
```
When you're done, you can run the following to delete everything:
```sh
sudo docker compose down --volumes # Delete all data and images in your Danbooru instance.
sudo docker image prune # Clean up all unused Docker images.
rm -rf ~/danbooru # Delete the Danbooru code.
```
## Installation
See the [Docker Guide](https://github.com/danbooru/danbooru/wiki/Docker-Guide) for more information on running Danbooru using Docker. This is the recommended way to run Danbooru.
Alternatively, you may use the [Manual Installation Guide](https://github.com/danbooru/danbooru/wiki/Manual-Installation-Guide) to install Danbooru without Docker. Manual installation is much more difficult than using Docker, and therefore is not recommended or officially supported.
For help, ask in the [#technical](https://discord.com/channels/310432830138089472/310846683376517121) channel on the [Danbooru Discord](https://discord.gg/danbooru), or in the [discussions area](https://github.com/danbooru/danbooru/discussions) on Github.
## 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).