kemono2/docs/FAQ.md

# Frequently Asked Questions

## My dump doesn't migrate.

_This assumes a running setup._

1.  Enter into database container:

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

2.  Check the contents of the  `posts`  table.

    ```sql
    SELECT * FROM posts;
    ```

    _Most likely it has  `0`  rows._

3.  Move contents of  `booru_posts`  ➞  `posts`

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

4.  Restart the archiver.

    ```sh
    docker restart kemono-archiver
    ```

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

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

    ```sh
    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.

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

3.  Restart the archiver to trigger migrations.

    ```sh
    docker restart kemono-archiver
    ```

    If that didn't start the migrations, refer <br>
    to  [My Dump Doesn't Migrate](#my-dump-doesnt-migrate)  section.

## How do I put files into nginx container?

1.  Retrieve the files in required folder structure.

2.  Copy them into nginx image.

    ```sh
    docker \
        cp ./ kemono-nginx:/storage
    ```

3.  Add required permissions to that folder.

    ```sh
    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:

   ```sh
   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:

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

3. Confirm python 3.12 is installed
   ```sh
   which python3.12
   ```