{"id":50993331,"url":"https://github.com/hstefan/pqno","last_synced_at":"2026-06-20T05:32:42.842Z","repository":{"id":348903530,"uuid":"1200331565","full_name":"hstefan/pqno","owner":"hstefan","description":"Minimal self-hosted URL shortener written in Rust","archived":false,"fork":false,"pushed_at":"2026-04-03T10:08:10.000Z","size":820,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-04-03T15:23:13.905Z","etag":null,"topics":["docker","k3s","kubernetes","rocket","rust","self-hosted","sqlite","url-shortener"],"latest_commit_sha":null,"homepage":null,"language":"HTML","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/hstefan.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-04-03T09:36:29.000Z","updated_at":"2026-04-03T10:08:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hstefan/pqno","commit_stats":null,"previous_names":["hstefan/pqno"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/hstefan/pqno","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hstefan%2Fpqno","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hstefan%2Fpqno/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hstefan%2Fpqno/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hstefan%2Fpqno/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hstefan","download_url":"https://codeload.github.com/hstefan/pqno/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hstefan%2Fpqno/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34558894,"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-20T02:00:06.407Z","response_time":98,"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","k3s","kubernetes","rocket","rust","self-hosted","sqlite","url-shortener"],"created_at":"2026-06-20T05:32:42.049Z","updated_at":"2026-06-20T05:32:42.828Z","avatar_url":"https://github.com/hstefan.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# pqno\n\n**Minimal self-hosted URL shortener written in Rust.**\n\nMap short slugs to URLs and serve instant redirects — no accounts, no tracking, no nonsense. Ships as a single binary with an embedded SQLite database and a clean dark web UI.\n\n![pqno screenshot](docs/screenshot.png)\n\n## Features\n\n- **Fast** — built on [Rocket](https://rocket.rs), serves redirects in microseconds\n- **Persistent** — SQLite backend, survives restarts, no external database required\n- **Clean UI** — dark web interface to create, browse, and remove links\n- **Validated** — rejects malformed or non-HTTP(S) URLs at both the API and UI layer\n- **Kubernetes-ready** — Helm-free k8s manifests included, Traefik ingress, PVC for storage\n- **Multi-arch** — Docker image built for `linux/amd64` and `linux/arm64`\n\n## Quick start\n\n```bash\ncargo run\n```\n\nOpen `http://localhost:8000`. Links are stored in `pqno.db`.\n\n## API\n\n```\nPOST /           {\"slug\": \"gh\", \"url\": \"https://github.com\"}  →  201 Created\nGET  /\u003cslug\u003e     →  302 redirect\nDELETE /\u003cslug\u003e   →  204 No Content\nGET  /links      →  {\"slug\": \"url\", ...}\n```\n\n## Docker\n\n```bash\ndocker run -p 8000:8000 -v $(pwd)/data:/data \\\n  -e DB_PATH=/data/pqno.db \\\n  hstefanp/pqno:latest\n```\n\n## Kubernetes (k3s)\n\n```bash\nmake build    # build \u0026 push multi-arch image to Docker Hub\nmake deploy   # apply manifests (namespace, PVC, Deployment, Service, Ingress)\nmake restart  # rolling restart after a new image push\n```\n\nManifests live in `k8s/`. The app runs in the `pqno` namespace behind a Traefik ingress. SQLite is mounted from a `local-path` PVC — keep `replicas: 1`.\n\n## Configuration\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `DB_PATH` | `pqno.db` | Path to the SQLite database file |\n| `ROCKET_ADDRESS` | `127.0.0.1` | Bind address (`0.0.0.0` in containers) |\n| `ROCKET_PORT` | `8000` | Listen port |\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhstefan%2Fpqno","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhstefan%2Fpqno","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhstefan%2Fpqno/lists"}