⚠️ Using commands can slow down huge batch downloads (a recent computer may need from 100ms to 1s more per image) ⚠️


ℹ️ Note that this is inspired by the official INSTALL.md file, so feel free to refer to the official install documentation instead.

Install Docker

You need Docker to be installed on your maching to use Szurubooru. Setup instructions can be found here for Windows: https://docs.docker.com/docker-for-windows/install/

Download Szurubooru

  • Download the Git archive and unzip it somewhere
  • Open Docker settings, and in “Resources > File sharing”, add the Szurubooru directory
  • Copy server/config.yaml.dist to server/config.yaml
  • Copy doc/example.env to .env (at the root directory)

Setup the data directory

Create a data directory somewhere (for example, at the root directory of Szurubooru). Note that this will be where all the images are stored!

Set the MOUNT_DATA environment variable to point to the data directory (on Windows: right click “This computer > Properties > Advanced system settings > Environment Variables”)


  • Open a terminal in the Szurubooru directory
  • Run docker-compose pull
  • Run docker-compose up -d

You’re done! You should be able to access Szurubooru in your browser at http://localhost:8080/


  • Create an account on the registration page, you should automatically be an administrator
  • Create tag categories in the tag categories page (it is recommended to at least add the “character”, “copyright”, and “artist” categories)
  • Create a token with a very late expiration date in “Account > Login tokens”


Install NodeJS

You need NodeJS to be installed on your maching to use the upload script used by Grabber. Just run the installer you can find on their website: https://nodejs.org/en/

On Linux, you can just do:

sudo apt-get install nodejs

Download the upload script

Download the szurubooru.js file into Grabber’s installation folder.

Note that this script uses the NodeJS “form-data” plugin, so install it with:

npm install -g form-data

Make sure the NODE_PATH environment variable is properly set to point to your global node_modules folder. On Windows, it’s usually:


But you can check the exact path with:

npm root -g


Open Grabber, then go to “Options > Commands”, and set the “Image” field to:

node szurubooru.js "YOUR_USERNAME" "YOUR_TOKEN" "%all%" "%rating%" "%source%" "%path%"

Make sure to replace YOUR_USERNAME by your Szurubooru username, and YOUR_TOKEN by the token created earlier (in the xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx format or similar).