{"id":50412479,"url":"https://github.com/tiwut/docker-md-server","last_synced_at":"2026-05-31T04:30:24.306Z","repository":{"id":359852179,"uuid":"1247750893","full_name":"tiwut/docker-md-server","owner":"tiwut","description":"A lightweight, 100% C++ written web server for hosting Markdown files, featuring an integrated web file manager.","archived":false,"fork":false,"pushed_at":"2026-05-23T18:27:29.000Z","size":10,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-23T20:17:17.091Z","etag":null,"topics":["docker","markdown-language","web-server"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/tiwutdev/docker-md-server","language":"C++","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/tiwut.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-05-23T18:21:41.000Z","updated_at":"2026-05-23T18:30:23.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/tiwut/docker-md-server","commit_stats":null,"previous_names":["tiwut/docker-md-server"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/tiwut/docker-md-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiwut%2Fdocker-md-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiwut%2Fdocker-md-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiwut%2Fdocker-md-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiwut%2Fdocker-md-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tiwut","download_url":"https://codeload.github.com/tiwut/docker-md-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiwut%2Fdocker-md-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33719601,"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-05-31T02:00:06.040Z","response_time":95,"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":["docker","markdown-language","web-server"],"created_at":"2026-05-31T04:30:23.635Z","updated_at":"2026-05-31T04:30:24.292Z","avatar_url":"https://github.com/tiwut.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Tiwut Docker Markdown Server\n\n\u003cimg width=\"837\" height=\"676\" alt=\"image\" src=\"https://github.com/user-attachments/assets/a8f56c0a-f8a6-4934-9091-1889577a785c\" /\u003e\n\n\n```yaml\nversion: '3.8'\n\nservices:\n  md-server:\n    image: tiwutdev/docker-md-server:latest\n    ports:\n      - \"8080:8080\"\n      - \"8081:8081\"\n    volumes:\n      - ./www:/app/www\n    restart: unless-stopped\n```\n\nA lightweight, 100% C++ written web server for hosting Markdown files, featuring an integrated web file manager.\n\n## Architecture\n- **Pure C++17:** Zero external dependencies (only requires libc/libstdc++).\n- **Public Port (8080):** Renders `.md` files dynamically in the browser using `marked.js`. Supports custom CSS and JS.\n- **Admin Port (8081):** Full web UI for file management (editor, upload, folder creation, rename, delete, copy).\n\n## Setup \u0026 Run\n\n1. Build and start the container using Docker Compose:\n```bash\n   docker-compose up -d --build\n```\n\n\n- **Accessing the Server:**\n\n- **Frontend:** [http://localhost:8080](https://www.google.com/search?q=http://localhost:8080)\n- **Admin UI:** [http://localhost:8081](https://www.google.com/search?q=http://localhost:8081)\n\n## File Structure\n\nAll files are saved in the local directory ./www, mounted into the container via Docker volumes.\n\n- index.md: The main page.\n- style.css: Styling (dark mode design included).\n- script.js: Your custom JavaScript.\n\n## Admin Panel Features\n\n- **Live Editor:** Edit Markdown, CSS, and JS files directly in the browser.\n- **Hotkeys:** Save changes quickly using Ctrl + S.\n- **Upload:** Use the upload button to easily deploy assets like images or PDFs.\n- **Security:** Path sanitization blocks directory traversal attacks (../).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftiwut%2Fdocker-md-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftiwut%2Fdocker-md-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftiwut%2Fdocker-md-server/lists"}