{"id":50664329,"url":"https://github.com/aiursoftweb/apkg","last_synced_at":"2026-06-08T05:01:08.561Z","repository":{"id":352962313,"uuid":"1217167519","full_name":"AiursoftWeb/Apkg","owner":"AiursoftWeb","description":"An APT server. Allows you to distribute your packages.","archived":false,"fork":false,"pushed_at":"2026-06-02T06:20:41.000Z","size":89789,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-06-02T08:17:33.346Z","etag":null,"topics":["anduinos","apt","apt-get","apt-server","artifacts-repository"],"latest_commit_sha":null,"homepage":"https://apkg.aiursoft.com/","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AiursoftWeb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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-21T16:00:31.000Z","updated_at":"2026-06-02T06:20:46.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/AiursoftWeb/Apkg","commit_stats":null,"previous_names":["aiursoftweb/apkg"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/AiursoftWeb/Apkg","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AiursoftWeb%2FApkg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AiursoftWeb%2FApkg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AiursoftWeb%2FApkg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AiursoftWeb%2FApkg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AiursoftWeb","download_url":"https://codeload.github.com/AiursoftWeb/Apkg/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AiursoftWeb%2FApkg/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34048682,"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-08T02:00:07.615Z","response_time":111,"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":["anduinos","apt","apt-get","apt-server","artifacts-repository"],"created_at":"2026-06-08T05:00:42.626Z","updated_at":"2026-06-08T05:01:08.544Z","avatar_url":"https://github.com/AiursoftWeb.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Apkg\n\n[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/aiursoftweb/apkg/blob/master/LICENSE)\n[![Pipeline stat](https://gitlab.aiursoft.com/aiursoft/apkg/badges/master/pipeline.svg)](https://gitlab.aiursoft.com/aiursoft/apkg/-/pipelines)\n[![Test Coverage](https://gitlab.aiursoft.com/aiursoft/apkg/badges/master/coverage.svg)](https://gitlab.aiursoft.com/aiursoft/apkg/-/pipelines)\n[![Man hours](https://manhours.aiursoft.com/r/github.com/aiursoftweb/apkg.svg)](https://manhours.aiursoft.com/r/github.com/aiursoftweb/apkg.html)\n[![Website](https://img.shields.io/website?url=https%3A%2F%2Fapkg.aiursoft.com)](https://apkg.aiursoft.com)\n[![Docker](https://img.shields.io/docker/pulls/aiursoft/apkg.svg)](https://hub.docker.com/r/aiursoft/apkg)\n\nApkg is an APT package hosting server paired with a `dotnet` global CLI tool for creating, packaging, and publishing `.apkg` files.\n\n![screenshot](./screenshot.png)\n\nDefault user name is `admin@default.com` and default password is `Admin@123456!`.\n\n## Install APKG CLI\n\n**Prerequisites:** [.NET 10 SDK](https://dotnet.microsoft.com/download)\n\n```bash\ndotnet tool install --global Aiursoft.Apkg.Client --add-source https://nuget.aiursoft.com/v3/index.json\n```\n\nAfter installing, verify with `apkg --help`.\n\n### Quick workflow\n\n```bash\n# 1. Create a new package\napkg new --name my-package\n\n# 2. Build and publish (creates .apkg in bin/)\napkg publish --path ./my-package\n\n# 3. Push to server\napkg push ./my-package/bin/my-package.apkg --source https://apkg.example.com --api-key \u003cyour-key\u003e\n\n# 4. Add a repository as an APT source on a client machine (requires sudo)\nsudo apkg add-source https://apkg.example.com/api/sources/1\n\n# 5. Install the package via apt as normal\nsudo apt install my-package\n```\n\n## Try\n\nTry a running Apkg [here](https://apkg.aiursoft.com).\n\n## Run in Ubuntu\n\nThe following script will install\\update this app on your Ubuntu server. Supports Ubuntu 25.04. Also works on AnduinOS (an Ubuntu/Debian derivative).\n\nOn your Ubuntu server, run the following command:\n\n```bash\ncurl -sL https://github.com/aiursoftweb/apkg/raw/master/install.sh | sudo bash\n```\n\nOf course it is suggested that append a custom port number to the command:\n\n```bash\ncurl -sL https://github.com/aiursoftweb/apkg/raw/master/install.sh | sudo bash -s 8080\n```\n\nIt will install the app as a systemd service, and start it automatically. Binary files will be located at `/opt/apps`. Service files will be located at `/etc/systemd/system`.\n\n## Run manually\n\nRequirements about how to run\n\n1. Install [.NET 10 SDK](http://dot.net/) and [Node.js](https://nodejs.org/).\n2. Execute `npm install` at `wwwroot` folder to install the dependencies.\n3. Execute `dotnet run` to run the app.\n4. Use your browser to view [http://localhost:5000](http://localhost:5000).\n\n## Run in Microsoft Visual Studio\n\n1. Open the `.sln` file in the project path.\n2. Press `F5` to run the app.\n\n## Run in Docker\n\nFirst, install Docker [here](https://docs.docker.com/get-docker/).\n\nThen run the following commands in a Linux shell:\n\n```bash\nimage=aiursoft/apkg\nappName=apkg\nsudo docker pull $image\nsudo docker run -d --name $appName --restart unless-stopped -p 5000:5000 -v /var/www/$appName:/data $image\n```\n\nThat will start a web server at `http://localhost:5000` and you can test the app.\n\nThe docker image has the following context:\n\n| Properties  | Value                           |\n|-------------|---------------------------------|\n| Image       | aiursoft/apkg               |\n| Ports       | 5000                            |\n| Binary path | /app                            |\n| Data path   | /data                           |\n| Config path | /data/appsettings.json          |\n\n## How to contribute\n\nThere are many ways to contribute to the project: logging bugs, submitting pull requests, reporting issues, and creating suggestions.\n\nEven if you with push rights on the repository, you should create a personal fork and create feature branches there when you need them. This keeps the main repository clean and your workflow cruft out of sight.\n\nWe're also interested in your feedback on the future of this project. You can submit a suggestion or feature request through the issue tracker. To make this process more effective, we're asking that these include more information to help define them more clearly.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faiursoftweb%2Fapkg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faiursoftweb%2Fapkg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faiursoftweb%2Fapkg/lists"}