{"id":50728380,"url":"https://github.com/1mb-dev/log","last_synced_at":"2026-06-10T06:03:05.496Z","repository":{"id":358275448,"uuid":"1240479210","full_name":"1mb-dev/log","owner":"1mb-dev","description":"Public reference deployment of markgo at log.1mb.dev — fork to serve your own blog with TLS, AMA, and PWA, supervised by systemd behind Caddy.","archived":false,"fork":false,"pushed_at":"2026-06-03T05:55:11.000Z","size":1814,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-03T07:30:29.417Z","etag":null,"topics":["blog","caddy","markgo","pwa","reference-deployment","self-hosted","systemd","vps"],"latest_commit_sha":null,"homepage":"https://log.1mb.dev","language":"Shell","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/1mb-dev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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-05-16T07:17:13.000Z","updated_at":"2026-06-03T05:55:15.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/1mb-dev/log","commit_stats":null,"previous_names":["1mb-dev/log"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/1mb-dev/log","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1mb-dev%2Flog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1mb-dev%2Flog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1mb-dev%2Flog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1mb-dev%2Flog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/1mb-dev","download_url":"https://codeload.github.com/1mb-dev/log/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1mb-dev%2Flog/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34139187,"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-10T02:00:07.152Z","response_time":89,"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":["blog","caddy","markgo","pwa","reference-deployment","self-hosted","systemd","vps"],"created_at":"2026-06-10T06:03:04.691Z","updated_at":"2026-06-10T06:03:05.489Z","avatar_url":"https://github.com/1mb-dev.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# log\n\nReference deployment of [markgo](https://github.com/1mb-dev/markgo) at [log.1mb.dev](https://log.1mb.dev). A working example of how to fork markgo onto a VPS and serve a blog with TLS, AMA, and PWA support.\n\nThe published content under `articles/` is the maintainer's writing. The deploy harness -- `Makefile`, Caddy + systemd templates, `.env.example`, deployment guide -- is the part you copy when forking.\n\n## Quick deploy\n\nPrerequisites: a Linux VPS you can `ssh` to, a domain whose A record points at it (required before first deploy for Let's Encrypt's HTTP-01 challenge), Go 1.26+ and `make` locally, Caddy v2 on the VPS.\n\n```sh\n# Fork on GitHub, then clone your fork\ngit clone https://github.com/yourname/your-blog.git \u0026\u0026 cd your-blog\n\n# Build the markgo binary for your server (Makefile pins the version)\nmake fetch-markgo GOOS=linux GOARCH=amd64\n\n# Customise\ncp .env.example .env                  # edit BASE_URL, BLOG_*, ADMIN_*, CORS\n$EDITOR articles/                     # replace with your own writing\n$EDITOR static/                       # swap or remove the overrides\n\n# Deploy (after .env is populated and DNS resolves to the VPS)\nmake deploy DOMAIN=your.domain.example\n```\n\n`make deploy` pushes binary + content + `.env`, installs the systemd unit with templated user/paths, restarts the service, and runs `scripts/verify-deploy.sh` to confirm health. See [`docs/deployment.md`](docs/deployment.md) for the manual sequence, DNS setup, and systemd/Caddy details.\n\n## What you get\n\nA markgo deployment with:\n\n- **Articles**, **Thoughts**, **Links** as content types, with type inferred from frontmatter or filename when omitted.\n- **AMA** (Ask Me Anything): readers submit questions with math captcha + honeypot; you moderate at `/admin/ama`; published Q\u0026As flow into the home feed.\n- **Compose form** at `/compose` for publishing from any device once authenticated.\n- **PWA**: installable, offline reading, service worker, dynamic manifest.\n- **SEO**: RSS, sitemap, JSON-LD `Article` schema, OG cards.\n- No analytics. No comments. No engagement features beyond AMA.\n\nFull feature surface lives in [markgo's docs](https://github.com/1mb-dev/markgo/tree/main/docs).\n\n## When to use this\n\nFork this when you want a self-hosted, markdown-in-git blog with a small operational footprint — single Go binary, one systemd unit, Caddy in front for TLS. Comfortable on a small VPS (markgo is ~15 MiB resident). For the same orientation in fewer words, see [Run your own?](https://log.1mb.dev/p/run-your-own).\n\nNot for you if a static-site generator is enough (no dynamic features needed), if you want plugins / themes / multi-author dashboards (use Ghost or WordPress), if you don't want to run a server at all (use Bear, Mataroa, Substack), or if you have your own deploy tooling around the engine (use [markgo](https://github.com/1mb-dev/markgo) directly).\n\n## Repository layout\n\n```\nlog/\n├── articles/                  Blog content (markdown + frontmatter). Replace with yours.\n├── static/                    Visual overrides on top of markgo's defaults. Treat as examples.\n├── deploy/\n│   ├── Caddyfile.example      Caddy vhost (reverse proxy + TLS via Let's Encrypt)\n│   └── log.service.example    Hardened systemd unit\n├── docs/deployment.md         Step-by-step deploy guide\n├── Makefile                   fetch-markgo, build, deploy DOMAIN=...\n├── .env.example               Production configuration template\n├── LICENSE                    MIT (repo structure)\n└── LICENSE-CONTENT.md         Content-licensing note (articles/ are © the author)\n```\n\n## Configuration\n\n`.env.example` is annotated against the markgo version pinned in the Makefile (`MARKGO_REF`). See [`docs/deployment.md`](docs/deployment.md) §4 for the required edits, and §5 for the Caddy / systemd install paths.\n\n## Customising\n\n- **Content type inference** -- see [markgo's design.md](https://github.com/1mb-dev/markgo/blob/main/docs/design.md).\n- **Visual overrides** go in `static/`. The reference deployment keeps overrides minimal and annotated; see [`static/README.md`](static/README.md). Adjust to taste rather than treating these as a finished design.\n- **Theme, navigation, and behavioural changes** belong upstream in markgo, not as patches in this repo.\n\n## License\n\nRepo structure (templates, deploy configs, Makefile, docs) is MIT — see [`LICENSE`](LICENSE). Content under `articles/` is the author's, all rights reserved — see [`LICENSE-CONTENT.md`](LICENSE-CONTENT.md). Forkers replace it with their own writing.\n\n## Status\n\nLive at [log.1mb.dev](https://log.1mb.dev). The deploy harness (`make deploy`, `scripts/verify-deploy.sh`, [`docs/deployment.md`](docs/deployment.md)) is what forkers copy; the corpus under `articles/` is the maintainer's. The markgo version is pinned in the [Makefile](Makefile) (`MARKGO_REF`).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1mb-dev%2Flog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F1mb-dev%2Flog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1mb-dev%2Flog/lists"}