{"id":18574376,"url":"https://github.com/atsign-foundation/dess","last_synced_at":"2025-04-10T07:33:08.198Z","repository":{"id":37084046,"uuid":"367226467","full_name":"atsign-foundation/dess","owner":"atsign-foundation","description":"The Distributed Edge Secondary Server (dess) - the self-hosted atServer installer","archived":false,"fork":false,"pushed_at":"2024-10-24T07:38:00.000Z","size":454,"stargazers_count":9,"open_issues_count":6,"forks_count":9,"subscribers_count":12,"default_branch":"trunk","last_synced_at":"2024-10-25T03:42:19.777Z","etag":null,"topics":["atsign","bash","hacktoberfest"],"latest_commit_sha":null,"homepage":"https://docs.atsign.com","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/atsign-foundation.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"code_of_conduct.md","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}},"created_at":"2021-05-14T02:20:31.000Z","updated_at":"2024-10-24T07:38:02.000Z","dependencies_parsed_at":"2023-02-15T06:35:24.888Z","dependency_job_id":"70779087-c328-4381-9567-6d7789dff9ed","html_url":"https://github.com/atsign-foundation/dess","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atsign-foundation%2Fdess","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atsign-foundation%2Fdess/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atsign-foundation%2Fdess/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atsign-foundation%2Fdess/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/atsign-foundation","download_url":"https://codeload.github.com/atsign-foundation/dess/tar.gz/refs/heads/trunk","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223430209,"owners_count":17143625,"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":["atsign","bash","hacktoberfest"],"created_at":"2024-11-06T23:14:54.838Z","updated_at":"2024-11-06T23:14:58.440Z","avatar_url":"https://github.com/atsign-foundation.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca href=\"https://atsign.com#gh-light-mode-only\"\u003e\u003cimg width=250px src=\"https://atsign.com/wp-content/uploads/2022/05/atsign-logo-horizontal-color2022.svg#gh-light-mode-only\" alt=\"The Atsign Foundation\"\u003e\u003c/a\u003e\u003ca href=\"https://atsign.com#gh-dark-mode-only\"\u003e\u003cimg width=250px src=\"https://atsign.com/wp-content/uploads/2023/08/atsign-logo-horizontal-reverse2022-Color.svg#gh-dark-mode-only\" alt=\"The Atsign Foundation\"\u003e\u003c/a\u003e\n\n[![GitHub License](https://img.shields.io/badge/license-BSD3-blue.svg)](./LICENSE)\n[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/atsign-foundation/dess/badge)](https://securityscorecards.dev/viewer/?uri=github.com/atsign-foundation/dess\u0026sort_by=check-score\u0026sort_direction=desc)\n[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/8133/badge)](https://www.bestpractices.dev/projects/8133)\n\n# README\n\nDistributed Edge Secondary Server (dess)\n\nThe atProtocol was written and developed with \"distribute what you can and\ncentralized what you must\" as a design philosophy. Each atSign has its own\nmicroservice and that microservice can run anywhere as long as it is directly\naddressable on the internet. By this we mean it has a dedicated DNS address\nand port number, also required is an SSL certificate to allow TLS encrypted\ncommunications.\n\nThis means that by design you can run your own secondary server or have someone\nyou trust to run it reliably run it for you. Why would you do that? Well\nperhaps you like to have the control, or your requirements need more\ninfrastructure than Atsign provide on their secondary infrastructure.\n\nWhatever the use case we want to make it easy for you run your own Secondary.\n\nWe welcome contributions - we want pull requests and to hear about issues.\nWe are also very interested in your use cases!\n\n## Who is this for?\n\nWe use Linux as our base OS, and any flavour is fine, we also use Docker.\nSo some basic Linux skills are useful. As with any Internet protocol, you\nwill need to provide internet access and in some cases may have to port forward\nto the secondary if your machine is perhaps behind a router or a firewall.\nIf you have set up NAT before then you will have no issues, if not it's\nworth understanding how you can provide the internet connectivity required\nin your environment before proceeding.\n\nFinally you will need an atSign and you can get a free one or a custom one\nat [atsign.com](https://atsign.com)\n\n### Contributor\n\nThese instructions are not going to cover every use case but if you found\nthem useful and found some things missing, please contribute and help others.\n[CONTRIBUTING.md](CONTRIBUTING.md) is going to have the detailed guidance on\nhow to setup tools, tests and how to make a pull request.\n\n## Why, What, How?\n\n### Why?\n\nRun your own secondary server on a light bulb to cloud server, on arm32, arm64\nor amd64 CPU architectures.\n\n### What?\n\nYou will need a machine with a Linux OS, installed along the way will be\ndocker, docker-compose\n\n### How?\n\nAn atsign Linux account will be created and docker will be used to gather SSL\ncertificates using LetsEncrypt. The secondary will be configured and started\nup as a Docker swarm service. That service will auto update when new software\nis pushed. Certificates will be renewed automatically, and crashes or other\nissues will be handled gracefully. The software your secondary uses will be\nthe exact same image as Atsign is using in production.\n\n[Instructions.md](Instructions.md) contains detailed instructions on how to\ninstall dess and create a secondary server using it.\n\n## Maintainers\n\nCreated by [cconstab](https://github.com/cconstab).\nIf you see something wrong let me know by raising an issue, or please\ncontribute by raising a pull request!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatsign-foundation%2Fdess","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fatsign-foundation%2Fdess","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatsign-foundation%2Fdess/lists"}