{"id":25456198,"url":"https://github.com/dezh-tech/alienos","last_synced_at":"2025-05-16T16:37:34.361Z","repository":{"id":276669832,"uuid":"928878830","full_name":"dezh-tech/alienos","owner":"dezh-tech","description":"A plugin-able and manageable Nostr stack (relay/blossom/nip-05) designed for self-hosting.","archived":false,"fork":false,"pushed_at":"2025-05-15T11:39:12.000Z","size":824,"stargazers_count":16,"open_issues_count":7,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-15T12:35:25.798Z","etag":null,"topics":["bitcoin","blossom","go","golang","media","mediaserver","nip05","nostr","relay","self-hosted","selfhosting"],"latest_commit_sha":null,"homepage":"","language":"Go","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/dezh-tech.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":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-02-07T12:02:49.000Z","updated_at":"2025-05-15T11:39:15.000Z","dependencies_parsed_at":"2025-03-15T19:27:06.125Z","dependency_job_id":"9bf92370-5778-4cc3-9e66-fddc6705874e","html_url":"https://github.com/dezh-tech/alienos","commit_stats":null,"previous_names":["dezh-tech/alienos"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dezh-tech%2Falienos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dezh-tech%2Falienos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dezh-tech%2Falienos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dezh-tech%2Falienos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dezh-tech","download_url":"https://codeload.github.com/dezh-tech/alienos/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254567952,"owners_count":22092869,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["bitcoin","blossom","go","golang","media","mediaserver","nip05","nostr","relay","self-hosted","selfhosting"],"created_at":"2025-02-18T01:29:20.491Z","updated_at":"2025-05-16T16:37:34.354Z","avatar_url":"https://github.com/dezh-tech.png","language":"Go","funding_links":[],"categories":["Relays","Server Implementations","Go"],"sub_categories":["Implementations"],"readme":"\u003cp align=\"center\"\u003e \n    \u003cimg alt=\"alienos\" src=\"./static/images/logo.png\" width=\"150\" height=\"150\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003e\nAlienos\n\u003c/h1\u003e\n\n\u003cbr/\u003e\n\n\nThe Alienos is a Nostr stack (relay/blossom mediaserver/nip-05 server) which is manageable (using nip-86) and [plugin-able](wip). We designed it for self-hosting and backups.\n\nThis project is based on [Khatru](https://github.com/fiatjaf/khatru), [Event Store](https://github.com/fiatjaf/eventstore), [Blob Store](github.com/kehiy/blobstore) and [Go Nostr](github.com/nbd-wtf/go-nostr).\n\n\n## Landing Page\n\n\u003cimg alt=\"alienos\" src=\"./static/images/screenshot.png\" /\u003e\n\n## Features\n\n- [X] Support NIPs: 1, 9, 11, 40, 42, 50, 56, 59, 70, 86.\n- [X] Support BUDs: 1, 2, 4, 6, 9 (Manageable using nip-86).\n- [X] NIP-05 server (Manageable using nip-86, caching for recent requests to enhance response delay).\n- [X] Manageable using NIP-86.\n- [X] Landing page with NIP-11 document.\n- [X] S3 backups (relay dbs/blobs/nip05 data/management info).\n- [X] Moderator notifications.\n- [X] S3 as blossom target.\n- [X] Colorful Console/File logger.\n- [ ] Running on Tor.\n- [ ] Support plugins.\n- [ ] StartOS support.\n- [ ] Umbrel support.\n\n## How to set it up?\n\n\n#### **Option 1: Use Prebuilt Docker Image (Recommended)**\n\nThe easiest way to run the Alienos is by using the prebuilt image:\n\n1. **Pull the latest image**\n\n   ```sh\n   docker pull dezhtech/alienos\n   ```\n\n2. **Run Alienos with environment variables**\n   ```sh\n   docker run -d --name alienos \\\n   -p 7771:7771 \\\n    -e ALIENOS_WORK_DIR=\"alienos_wd/\" \\\n    -e ALIENOS_RELAY_NAME=\"Alienos\" \\\n    -e ALIENOS_RELAY_ICON=\"https://nostr.download/6695de4b095cd99ee7b4f6e2ef9ff89a9029efc1a017e60b8b5b5cb446b2c1e0.webp\" \\\n    -e ALIENOS_RELAY_BANNER=\"https://nostr.download/5b3fa3e40365061d58946fdb1bc6549a4675186591f9f589f9983895bfac8940.webp\" \\\n    -e ALIENOS_RELAY_DESCRIPTION=\"A self-hosting Nostr stack!\" \\\n    -e ALIENOS_RELAY_PUBKEY=\"badbdda507572b397852048ea74f2ef3ad92b1aac07c3d4e1dec174e8cdc962a\" \\\n    -e ALIENOS_RELAY_CONTACT=\"hi@dezh.tech\" \\\n    -e ALIENOS_RELAY_SELF=\"\" \\\n    -e ALIENOS_RELAY_PORT=7771 \\\n    -e ALIENOS_RELAY_BIND=\"0.0.0.0\" \\\n    -e ALIENOS_RELAY_URL=\"\" \\\n    -e ALIENOS_BACKUP_ENABLE=\"true\" \\\n    -e ALIENOS_BACKUP_INTERVAL_HOURS=1 \\\n    -e ALIENOS_S3_ACCESS_KEY_ID=\"\" \\\n    -e ALIENOS_S3_SECRET_KEY=\"\" \\\n    -e ALIENOS_S3_ENDPOINT=\"\" \\\n    -e ALIENOS_S3_REGION=\"\" \\\n    -e ALIENOS_S3_BUCKET_NAME=\"alienos\" \\\n    -e ALIENOS_S3_AS_BLOSSOM_STORAGE=\"false\" \\ \n    -e ALIENOS_S3_BLOSSOM_BUCKET=\"alienos\" \\\n    -e ALIENOS_PUBKEY_WHITE_LISTED=\"false\" \\\n    -e ALIENOS_KIND_WHITE_LISTED=\"false\" \\\n    -e ALIENOS_ADMINS=\"\" \\\n    -e ALIENOS_LOG_FILENAME=\"alienos.log\" \\\n    -e ALIENOS_LOG_LEVEL=\"info\" \\\n    -e ALIENOS_LOG_TARGETS=\"file,console\" \\\n    -e ALIENOS_LOG_MAX_SIZE=10 \\\n    -e ALIENOS_LOG_FILE_COMPRESS=true \\\n   dezhtech/alienos\n   ```\n\n---\n\n#### **Option 2: Using Docker Compose**\n\nFor a more structured deployment, use **Docker Compose**:\n\n1. **use `compose.yml`**\nUse the existing compose file in the alienos directory\n\n2. **Run with Compose**\n   ```sh\n   docker-compose up -d\n   ```\n\n## Limitations\n\nThis project is highly suitable for personal, community, team, and backup usage because it is lightweight, feature-full, and easy to set up/manage.\n\nIf you are aiming to run a relay/nip-05 server/blossom media server for large-scale and high-load (as a paid relay, default relay for your client, or a public global relay), you can consider using the [Immortal](https://github.com/dezh-tech/immortal) relay and its adjacent projects.\n\n## Contribution\n\nAll kinds of contributions are welcome!\n\n## Donation\n\nDonations and financial support for the development process are possible using Bitcoin and Lightning:\n\n**on-chain**:\n\n```\nbc1qfw30k9ztahppatweycnll05rzmrn6u07slehmc\n```\n\n**lightning**: \n\n```\ndonate@dezh.tech\n```\n\n## License\n\nThis software is published under the [MIT License](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdezh-tech%2Falienos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdezh-tech%2Falienos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdezh-tech%2Falienos/lists"}