Wiki.js

Custom Iconify Server

How to setup your own Iconify server

Overview

You may want to run your own instance of the Iconify API server in the following use cases:

By default, Wiki.js calls the public api.iconify.com endpoint to search and fetch icons. You can override this endpoint by setting the icons.apiUrl parameter in your config.yml or using the ICONIFY_API_URL environment variable when using the docker image.

Setup

There multiple options for running an Iconify API server. The simplest one is to use the iconify/api docker image.

Download Icon Sets

All public icon sets can be downloaded from:
https://github.com/iconify/icon-sets/tree/master/json

It's recommended to download at least the following sets:

Example Docker Compose

The following example includes both Wiki.js and an Iconify server.

For the iconify container:

For the wiki container:

compose.yaml
services:

  db:
    image: postgres:18
    environment:
      POSTGRES_DB: wiki
      POSTGRES_PASSWORD: wikijsrocks
      POSTGRES_USER: wikijs
    restart: unless-stopped
    volumes:
      - db-data:/var/lib/postgresql

  iconify:
    image: iconify/api:3.2.0
    environment:
      ICONIFY_SOURCE: none
    restart: unless-stopped
    volumes:
      - /wiki/icons:/data/iconify-api/icons

  wiki:
    image: ghcr.io/requarks/wiki:3.3.1
    depends_on:
      - db
      - iconify
    environment:
      DB_HOST: db
      DB_USER: wikijs
      DB_PASS: wikijsrocks
      DB_NAME: wiki
      ICONIFY_API_URL: http://iconify:3000
    restart: unless-stopped
    ports:
      - "80:3000"
    volumes:
      - /wiki/config.yml:/wiki/config.yml

volumes:
  db-data: