{"id":47934460,"url":"https://github.com/5000k/5000blogs","last_synced_at":"2026-04-06T10:00:58.662Z","repository":{"id":342877834,"uuid":"1171013791","full_name":"5000K/5000blogs","owner":"5000K","description":"A minimal, markdown-based blog engine.","archived":false,"fork":false,"pushed_at":"2026-03-31T11:17:49.000Z","size":435,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"development","last_synced_at":"2026-04-04T07:38:14.967Z","etag":null,"topics":["blog","blogging","markdown","self-hosted","selfhosting"],"latest_commit_sha":null,"homepage":"https://5000blogs.5000K.org/","language":"Go","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/5000K.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":"2026-03-02T19:26:24.000Z","updated_at":"2026-03-31T11:15:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/5000K/5000blogs","commit_stats":null,"previous_names":["5000k/5000blogs"],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/5000K/5000blogs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/5000K%2F5000blogs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/5000K%2F5000blogs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/5000K%2F5000blogs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/5000K%2F5000blogs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/5000K","download_url":"https://codeload.github.com/5000K/5000blogs/tar.gz/refs/heads/development","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/5000K%2F5000blogs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31467985,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-06T08:36:52.050Z","status":"ssl_error","status_checked_at":"2026-04-06T08:36:51.267Z","response_time":112,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["blog","blogging","markdown","self-hosted","selfhosting"],"created_at":"2026-04-04T07:38:09.692Z","updated_at":"2026-04-06T10:00:58.647Z","avatar_url":"https://github.com/5000K.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"**You are looking at the development branch. Look at the [stable branch](https://github.com/5000K/5000blogs/tree/stable) for the current release version.**\n\n# \u003cimg src=\"./template/icon.png\" width=\"64\"/\u003e 5000blogs\n\n\u003e ! 5000blogs is nearly feature-stable, but config and API might still change. In the future, there probably will be manual migrations (mostly regarding your config and template) needed towards version 1.0. We will help with them. But they will probably be needed.\n\n## About\n5000blogs is a lightweight platform for blogging and publishing markdown files.\n\nYou can use it either as a complete backend to drive your blog, digital garden, or documentation - or you can use it as a library to build something more custom!\n\nThis repo contains a full engine capable of driving your markdown-based blog, including a reference implementation of a full blog server that you can use directly and extend if you ever need to.\n\nIt was built and tested to be easily able to reach a score of 100 in every category of chrome lighthouse tests, automatically generate social media preview images, rss and atom feeds, sitemaps, robots.txt and anything else you might want for optimal SEO.\n\n\n## Documentation\nCurrently, we have full documentation for using [5000blogs as a blog server](https://5000blogs.5000k.org) (which is powered by 5000blogs). We will publish documentation for using 5000blogs as a library once our API is stable, probably once we are nearing version `1.0`.\n\n# Run a demo\n\n\u003e assumes a terminal opened within the cloned repository, with go or docker set up\n\n## Run the demo locally\n```bash\nCONFIG_PATH=./config.demo.yml go run .\n```\n\n## Run the demo with Docker\n```bash\ndocker compose up --build\n```\n\n# Deploy your own blog\n5000blogs does not have any runtime dependencies and executes no writing operations, so it would be reasonable to just use a binary build. But it is recommended to use docker(-compose) for this, to keep things clean and reproducible.\n\nHere is a simple docker-compose.yml, that simply mounts a config and a posts folder:\n```yml\nservices:\n  5000blogs:\n    image: ghcr.io/5000k/5000blogs:latest\n    ports:\n      - \"8080:8080\"\n    volumes:\n      - ./config.yml:/config.yml:ro\n      - ./posts:/posts:ro\n```\n\nOr using docker run:\n```bash\ndocker run -d \\\n  --name 5000blogs \\\n  -p 8080:8080 \\\n  -v ./config.yml:/config.yml:ro \\\n  -v ./posts:/posts:ro \\\n  ghcr.io/5000k/5000blogs:latest\n```\n\nAnd here is a simple config.yml that you can tweak:\n```yml\nblog_name: Blog\n\nsite_url: http://localhost:8080 # the URL your blog will be available under. Very relevant for a functional RSS-feed!\n\n# These are quick links that will be shown in the top bar.\n# Use this to link to whatever are the most important pages on your site.\n# These could also be links to other websites.\nnav_links:\n  - name: 'Posts'\n    url: '/posts'\n```\n\nFor full instructions, read our [Docs](https://5000blogs.5000k.org).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F5000k%2F5000blogs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F5000k%2F5000blogs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F5000k%2F5000blogs/lists"}