kemono2/docs/FAQ.md

Frequently Asked Questions

My dump doesn't migrate.

This assumes a running setup.

1. Enter into database container:

   docker exec                 \
       --interactive           \
       --username=nano         \
       --tty kemono-db psql    \
       kemonodb
   

2. Check the contents of the  posts  table.

   SELECT * FROM posts;
   

   Most likely it has  0  rows.

3. Move contents of  booru_posts  ➞  posts

   INSERT INTO posts SELECT * FROM booru_posts ON CONFLICT DO NOTHING;
   

4. Restart the archiver.

   docker restart kemono-archiver
   

   If you see a bunch of log entries from  kemono-db ,
   then this indicates that the archiver is doing it's job.

5. In case the frontend still doesn't show
   the artists / posts, clear the redis cache.

   docker exec         \
       kemono-redis    \
       redis-cli       \
       FLUSHALL
   

How do I import from db dump?

1. Retrieve a database dump.

2. Run the following in the folder of said dump.

   cat db-filename.dump                \
       | gunzip                        \
       | docker exec                   \
       --interactive kemono-db psql    \
       --username=nano kemonodb
   

3. Restart the archiver to trigger migrations.

   docker restart kemono-archiver
   

   If that didn't start the migrations, refer
   to  My Dump Doesn't Migrate  section.

How do I put files into nginx container?

1. Retrieve the files in required folder structure.

2. Copy them into nginx image.

   docker \
       cp ./ kemono-nginx:/storage
   

3. Add required permissions to that folder.

   docker                  \
       exec kemono-nginx   \
       chown --recursive   \
       nginx /storage
   

How Do I Install Python 3.12 on Ubuntu 22?

Through a PPA (Personal Package Archives).

1. Install required tooling and add the PPA:

   sudo apt install --assume-yes software-properties-common
   sudo add-apt-repository ppa:deadsnakes/ppa
   

2. Update local apt listing and install required python dependencies:

   sudo apt update
   sudo apt install \
     python3.12 \
     python3.12-dev \
     python3.12-distutils
   

3. Confirm python 3.12 is installed

   which python3.12