Nora

A frontend alternative for TubeArchivist, built on the Astro Web Framework with Zorn integration.

Installation Setup

Requirements

• Docker
  • Linux
  • macOS (Homebrew, without Docker Desktop)
  • Windows (WSL2, without Docker Desktop)

SudoVanilla advises against the use of the Docker Desktop application, as it is proprietary software.

Directory Setup

Create a new directory named nora and create the compose and configuration file.

mkdir nora
cd nora
touch compose.yml config.json

Compose File

For the Docker Compose file, use the following:

services:
    nora:
        image: oci.registry.sudovanilla.org/nora:amd64 # or use arm64
        ports:
            - 9133:4321
        volumes:
            - ./config.json:/nora/config.json:ro
            - /path/to/tubearchivist/cache/:/nora/public/cache/:ro
            - /path/to/tubearchivist/media/:/nora/public/media/:ro

Make sure the paths are setup correctly and that they're read only.

Configuration File

For the configuration file, put in your server URL and token(API Key):

{
    "TubeArchivist": {
        "Server": "https://tubearchivist.example.org",
        "Token": "0000000000000000000000000000000000000000"
    }
}

Launch

Once everything is setup properly, you should be good to go for launch. Run the up command in Docker Compose:

docker compose up -d

Assuming everything went smooth during launch, the instance should be available at http://localhost:9133.

License

Copyright (C) 2025 - 2026 MinPluto

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see https://www.gnu.org/licenses/.

---