{"id":50969378,"url":"https://github.com/aelithron/recordkeeper","last_synced_at":"2026-06-19T00:30:45.054Z","repository":{"id":287277968,"uuid":"964205085","full_name":"aelithron/recordkeeper","owner":"aelithron","description":"The wiki that loads pages in a blink.","archived":false,"fork":false,"pushed_at":"2026-05-13T01:15:22.000Z","size":1005,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-28T00:28:06.331Z","etag":null,"topics":["blazingly-fast","nextjs","nyns","website","wiki"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aelithron.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-04-10T21:11:16.000Z","updated_at":"2026-05-13T01:15:19.000Z","dependencies_parsed_at":"2025-04-10T22:26:04.296Z","dependency_job_id":"9204dfb2-079f-4282-a424-0a6e0a5c4a8b","html_url":"https://github.com/aelithron/recordkeeper","commit_stats":null,"previous_names":["aelithron/recordkeeper"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/aelithron/recordkeeper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aelithron%2Frecordkeeper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aelithron%2Frecordkeeper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aelithron%2Frecordkeeper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aelithron%2Frecordkeeper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aelithron","download_url":"https://codeload.github.com/aelithron/recordkeeper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aelithron%2Frecordkeeper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34513020,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-18T02:00:06.871Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blazingly-fast","nextjs","nyns","website","wiki"],"created_at":"2026-06-19T00:30:44.256Z","updated_at":"2026-06-19T00:30:45.036Z","avatar_url":"https://github.com/aelithron.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Recordkeeper\n**The wiki that loads pages in a blink.**\\\nA Markdown-based wiki, based around speed and simplicity.\n## Introduction\nRecordkeeper was designed for the Not-yet-named Server, a Minecraft SMP.\nThe name is inspired by the idea of a keeper of stories from eras past, or if you're so inclined, the history buff employee at the local library.\nThis software is meant to be lightweight and ✨**fast**✨, while still providing the basic features needed for a public wiki.\n## Install\nInstalling Recordkeeper is very simple.\n### Installing on Docker (Recommended)\nDocker is the easiest way to install Recordkeeper on your server.\n#### With Compose\nCopy the following Compose file to your server or computer, and name it `compose.yaml`:\n```yaml\nservices:\n  recordkeeper:\n    image: ghcr.io/aelithron/recordkeeper:latest\n    container_name: recordkeeper\n    environment:\n      WEBEDITOR: false\n      WEBEDITOR_PASSWORD: \"\u003cSet a password here\u003e\"\n    ports:\n      - \"3000:3000\"\n    volumes:\n      - ./wiki:/app/wiki\n    restart: unless-stopped\n```\nThen, simply run `docker compose up -d` in the directory of the file, and continue to \"After Installation\" below.\nYour `wiki` directory will be in the Compose file's directory.\n#### Without Compose\nRun the following command on your server or computer:\n```bash\ndocker run -d \\\n  --name recordkeeper \\\n  -e WEBEDITOR=false \\\n  -e WEBEDITOR_PASSWORD=\"\u003cSet a password here\u003e\" \\\n  -p 3000:3000 \\\n  -v $(pwd)/wiki:/app/wiki \\\n  --restart unless-stopped \\\n  ghcr.io/aelithron/recordkeeper:latest\n```\nThen, continue to \"After Installation\" below. Your `wiki` directory will be in your current directory.\n### Installing on Kubernetes\nThis is my (ael's) personally preferred method for installing Recordkeeper!\n1. Download the `manifests.yaml` file. You can find it [by clicking here](https://raw.githubusercontent.com/aelithron/recordkeeper/refs/heads/main/manifests.yaml), or in the repo (the link is just to the raw version of the one here in this repo).\n2. Make any other needed changes for your setup, such as changing the storage location, setting a different Namespace, or increasing the number of replicas.\n3. Run the command `kubectl apply -f (location of your manifest)`.\n\u003e Note: if you want to use Recordkeeper with Traefik on Kubernetes, feel free to dm me (`@aelithron` on discord), i've already configured it but it's a bit too unique to put here.\n\nFinally, continue to \"After Installation\" below. Your `wiki` directory is at `/usr/share/recordkeeper/wiki` by default.\n### After Installation\nCongrats on installing Recordkeeper! It will create a folder called `wiki`, which will store all of your Markdown files for wiki pages (location in your installation method's instructions). Also, the server exposes itself on port `3000` by default.\n- **Docker Note: DO NOT** edit the right side of the volume mount, Recordkeeper won't be able to find your files! You can move the left side if you want, though.\n- **Kubernetes Note: DO NOT** edit the `mountPath` on the container spec! If you alter the storage method, make sure that the mountPath in the Pod is always `/app/wiki`, or Recordkeeper won't be able to find your files! You can alter the host location or storage method if you want, however.\n#### Enabling the Web Editor\nIf enabling the Web Editor, alter your installation method's Environment Variables to contain:\n- `WEBEDITOR_PASSWORD` set to a valid password\n- `WEBEDITOR` set to `true`\n\nIf you are a Kubernetes user enabling the Web Editor: uncomment the Secret and set a (Base64-encoded) password. Also, make sure to set `WEBEDITOR` to `\"true\"` in the Deployment's spec.\n## Planned Features/Changes\n- Downloader (simple script that compiles all of the pages and turns them into a zip file for the user)\n- Enforce no subfolders (subfolders break the sidebar, so this will enforce the rule in the web editor API and make the sidebar ignore subfolders and their pages)\n- Built-in image hosting (either by implementing [my company's image server](https://github.com/blastoffwaters/static-content-server) or a custom Recordkeeper image server)\n- Unit testing (the project already contains Jest's infrastructure but doesn't yet have proper tests)\n## Credits\nThis project uses some [Font Awesome](https://fontawesome.com) and [Twemoji](https://github.com/twitter/twemoji) icons throughout.\n## Notes\nThe phrase **\"The wiki that loads pages in a blink.\"** is a marketing term, from when I noticed I could blink in roughly the same time it took for Recordkeeper to load a page.\nIt requires that you are on a good connection, physically close to the server hosting Recordkeeper, and that the server also has a good connection and adequate CPU/RAM.\nHowever, due to our SSR-based loading for public pages as well as our low usage of React client components, we are one of (if not the) fastest wiki softwares out there.\n## Support\nif you want support or need to ask any questions, feel free to dm me! `@aelithron` on discord, i should respond fairly quickly!\n(i put support at the bottom because the readme explains most things fine, though i don't mind dms, even for simple questions.)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faelithron%2Frecordkeeper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faelithron%2Frecordkeeper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faelithron%2Frecordkeeper/lists"}