{"id":24502508,"url":"https://github.com/juls0730/passport","last_synced_at":"2026-01-18T11:07:52.467Z","repository":{"id":262205897,"uuid":"886529227","full_name":"juls0730/passport","owner":"juls0730","description":"A dashboard, similar to Homer by @bastienwirtz","archived":false,"fork":false,"pushed_at":"2025-12-05T04:57:36.000Z","size":783,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-08T12:30:43.094Z","etag":null,"topics":["dashboard","fiber-framework","golang","handlebars","homepage","self-hosted","sqlite","toolbox","zqdgr"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsl-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/juls0730.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":"2024-11-11T06:19:02.000Z","updated_at":"2025-12-05T04:38:11.000Z","dependencies_parsed_at":"2024-11-11T07:24:22.131Z","dependency_job_id":"0e50d4ea-4ebd-42e4-a2f5-f5d58f7bd94e","html_url":"https://github.com/juls0730/passport","commit_stats":null,"previous_names":["juls0730/passport"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/juls0730/passport","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juls0730%2Fpassport","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juls0730%2Fpassport/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juls0730%2Fpassport/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juls0730%2Fpassport/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/juls0730","download_url":"https://codeload.github.com/juls0730/passport/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juls0730%2Fpassport/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28535156,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T10:13:46.436Z","status":"ssl_error","status_checked_at":"2026-01-18T10:13:11.045Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["dashboard","fiber-framework","golang","handlebars","homepage","self-hosted","sqlite","toolbox","zqdgr"],"created_at":"2025-01-21T23:10:17.252Z","updated_at":"2026-01-18T11:07:52.462Z","avatar_url":"https://github.com/juls0730.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Passport\n\nPassport is a simple, fast, and lightweight web dashboard/new tab replacement.\n\n\u003e \"I cant believe I've never broken it\" - me\n\n## Getting Started\n\n![Screenshot of Passport](/screenshot.png)\n\n### Prerequisites\n\n- [ZQDGR](https://github.com/juls0730/zqdgr)\n- [Go](https://go.dev/doc/install)\n- [sqlite3](https://www.sqlite.org/download.html)\n- [TailwdinCSS CLI](https://github.com/tailwindlabs/tailwindcss/releases/latest)\n\n## Usage\n\n### Docker\n\nPassport is available as a Docker image via this repository for both amd64 and arm64. This is the recommended way to run Passport.\n\n```bash\ndocker run -d --name passport -p 3000:3000 -v passport_data:/data -e PASSPORT_ADMIN_USERNAME=admin -e PASSPORT_ADMIN_PASSWORD=password ghcr.io/juls0730/passport:latest\n```\n\nMake sure to change the admin password to something secure. At `/data` is where all of passport's persistent data will be stored, such as image uploads and the sqlite database.\n\n### Building from source\n\nIf you want to build from source, you will need to install the dependencies first.\n\n```bash\n# note entirely necessary, but strongly recommended\ngo install github.com/juls0730/zqdgr@latest\n\n# install bun\ncurl -fsSL https://bun.sh/install | bash\n\n# install css build deps\nbun install\n\n# you may also have to install sqlite3...\n```\n\nThen you can build the binary.\n\n```bash\nzqdgr build\n```\n\nYou can then run the binary.\n\n### Configuration\n\n#### Passport configuration\n\n| Environment Variable                   | Description                                                                     | Required | Default |\n| -------------------------------------- | ------------------------------------------------------------------------------- | -------- | ------- |\n| `PASSPORT_DEV_MODE`                    | Enables dev mode                                                                | false    | false   |\n| `PASSPORT_ENABLE_PREFORK`              | Enables preforking                                                              | false    | false   |\n| `PASSPORT_ADMIN_USERNAME`              | The username for the admin dashboard                                            | true     |\n| `PASSPORT_ADMIN_PASSWORD`              | The password for the admin dashboard                                            | true     |\n| `PASSPORT_SEARCH_PROVIDER`             | The search provider to use for the search bar, without any query parameters     | true     |\n| `PASSPORT_SEARCH_PROVIDER_QUERY_PARAM` | The query parameter to use for the search provider, e.g. `q` for most providers | false    | q       |\n\n\u003e [!NOTE]\n\u003e Currently passport only supports search using a GET request.\n\n#### Weather configuration\n\nThe weather integration is optional, and will be enabled automatically if you provide an API key. The following only applies if you are using the OpenWeatherMap integration.\n\n| Environment Variable       | Description                                                               | Required | Default        |\n| -------------------------- | ------------------------------------------------------------------------- | -------- | -------------- |\n| `PASSPORT_WEATHER_API_KEY` | The OpenWeather API key                                                   | true     |                |\n| `WEATHER_PROVIDER`         | The weather provider to use, currently only `openweathermap` is supported | false    | openweathermap |\n| `WEATHER_TEMP_UNITS`       | The temperature units to use, either `metric` or `imperial`               | false    | metric         |\n| `WEATHER_LAT`              | The latitude of your location                                             | true     |                |\n| `WEATHER_LON`              | The longitude of your location                                            | true     |                |\n| `WEATHER_UPDATE_INTERVAL`  | The interval in minutes to update the weather data                        | false    | 15             |\n\n#### Uptime configuration\n\nThe uptime integration is optional, and will be enabled automatically if you provide an API key. The following only applies if you are using the UptimeRobot integration.\n\n| Environment Variable      | Description                                                        | Required | Default     |\n| ------------------------- | ------------------------------------------------------------------ | -------- | ----------- |\n| `UPTIME_PROVIDER`         | The uptime provider to use, either `uptimerobot` or `betteruptime` | false    | uptimerobot |\n| `PASSPORT_UPTIME_API_KEY` | The UptimeRobot API key                                            | true     |             |\n| `UPTIME_UPDATE_INTERVAL`  | The interval in seconds to update the uptime data                  | false    | 300         |\n\n### Adding links and categories\n\nThe admin dashboard can be accessed at `/admin`, you will be redirected to the login page if you are not logged in, use\nthe credentials you configured via the environment variables to login. Once logged in you can add links and categories.\n\n## License\n\nThis project is licensed under the BSL-1.0 License - see the [LICENSE](LICENSE) file for details\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuls0730%2Fpassport","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjuls0730%2Fpassport","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuls0730%2Fpassport/lists"}