{"id":13609178,"url":"https://github.com/deso-protocol/run","last_synced_at":"2026-01-16T19:51:39.672Z","repository":{"id":44906086,"uuid":"355704527","full_name":"deso-protocol/run","owner":"deso-protocol","description":"Run your own DeSo node","archived":false,"fork":false,"pushed_at":"2024-08-13T19:21:04.000Z","size":45,"stargazers_count":192,"open_issues_count":15,"forks_count":95,"subscribers_count":28,"default_branch":"main","last_synced_at":"2025-04-12T19:40:56.071Z","etag":null,"topics":["deso"],"latest_commit_sha":null,"homepage":"https://docs.deso.org","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/deso-protocol.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-04-07T23:04:42.000Z","updated_at":"2025-03-26T05:21:22.000Z","dependencies_parsed_at":"2024-05-07T22:35:03.581Z","dependency_job_id":"db7f2692-ade8-4308-a9eb-e6f370ccc9cf","html_url":"https://github.com/deso-protocol/run","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/deso-protocol/run","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deso-protocol%2Frun","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deso-protocol%2Frun/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deso-protocol%2Frun/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deso-protocol%2Frun/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deso-protocol","download_url":"https://codeload.github.com/deso-protocol/run/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deso-protocol%2Frun/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28482052,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: 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":["deso"],"created_at":"2024-08-01T19:01:33.054Z","updated_at":"2026-01-16T19:51:39.654Z","avatar_url":"https://github.com/deso-protocol.png","language":"Makefile","readme":"# Run your own DeSo node\n\nRunning your own DeSo node is easy:\n\n1. [Install Docker and Docker Compose](https://docs.docker.com/get-docker/) if you don't have it already\n    * On Mac and Windows, Docker comes with Docker Compose\n    * On Linux you need to install Docker Engine and Docker Compose separately\n2. Execute `make devnet`, `make testnet`, or `make mainnet` depending on which type of node you want to run\n    * This will automatically run the relevant docker-compose\n3. If you want to start from scratch, you can always do `make wipe` or `make {environment}-wipe`. This will\ndelete all prior blocks/data for your node and allow it to start syncing from scratch again.\n4. Visit http://localhost:4200. This will load the frontend service you just ran and show you all the\ndata that your node is syncing.\n\n## Check sync progress\n\nYou can check on the sync progress of your local node either by looking at the output\nor by looking in the admin panel of the frontend. \n\n1. Create a new user OR sign in with your existing seed phrase\n2. Head to the Admin panel to see your sync status. The tooltips should explain what\n   most things mean.\n\nIf you're looking at the output in the terminal, note\nthat there is a header-download phase that is usually pretty quick (a few minutes)\nfollowed by a block syncing phase (if you're running iwith --sync-type=blocksync) or\na hypersync phase (if you're running --sync-type=hypersync-archival). The sync type is\nspecified in the base.env and overridden by the docker-compose.yml file for each\nenvironment.\n\n## Reset your node\n\nIf your node fails to sync or you want to try syncing from scratch you can run `make wipe`.\n\n## Learning More\nIf you want to learn more about how the DeSo node works, you can start by reading each\nof the relevant docker-compose.yml files and the base.env file, which has a lot of\ncomments describing each of the flags.\n\nIf you want to know how the actual underlying node code works, check out\n[our docs page](https://docs.deso.org/). To learn more about building an app, see our\n[app tutorial](https://docs.deso.org/deso-tutorial-build-apps). To learn more about our architecture, including a code walkthrough,\nsee our [architecture overview](https://docs.deso.org/deso-repos/architecture-overview).\n\nTo run a validator, see our [validator instructions doc](https://docs.google.com/document/d/1WAy7ZaRPXeuuOdPdOhgqeWaDAdTUD_8UDOvj4jVxTlw/edit).\n\n## What's next?\nOnce your node is synced, you have access to the full firehose of DeSo\ndata in real time! Below are some tips on how take full advantage of your node.\n\n* Go to your Admin tab and watch the unfiltered feed update as your node\n  syncs. It's like a time machine!\n  - Note: If your node is having trouble syncing for some reason, try updating\n    the CONNECT_IPS flag in base.env to deso-seed-2.io or deso-seed-4.io and set\n    IGNORE\\_INBOUND\\_PEER\\_INV\\_MESSAGES to true while you sync. This will pick\n    a fairly reliable node as a sync peer and disregard messages from other\n    peers.\n* Try to whitelist some posts in the Admin tab and see that they've made their way\n  onto your global feed.\n* Read through the flags available in the base.env\n  file. You can adjust these flags however you want, but note that some flags may be\n  overridden in the docker-compose.yml files so just make sure you edit them there if they're\n  set.\n* Set ADMIN\\_PUBLIC\\_KEYS to your public key so that the Admin tab is only\n  visible to your account.\n* Set SUPER\\_ADMIN\\_PUBLIC\\_KEYS to your public key so that the super admin tab is only\n  visible to your account.\n* Whitelist some posts and verify that they show up on the global feed.\n* Deploy your node on any cloud provider with a static IP to make it accessible\n  to anyone on the internet.\n  - If you do this, you must point *two* domains at your node.\n    domain.com *and* api.domain.com.\n  - If you do this, you *must* add your domain to the Caddyfile.dev's\n    Content-Security-Policy or your site won't work. You will need to add two\n    entries: One for domain.com:\\* and one for api.domain.com:\\*\n* Add the necessary nginx configuration for your SSL certificates generated by letsencrypt\n* Set the TWILIO\\* flags to allow new users to get some starter DeSo.\n* Set a SUPPORT\\_EMAIL so your users can contact you if they run into trouble.\n* Play with the logging verbosity by increasing GLOG\\_V.\n\n## Need help?\nYou can often find ansers in the [DeSo PoS Discussion Telegram Channel](https://t.me/deso_pos_discussion)\nThe dev team is also active on all DeSo apps such as diamondapp.com and focus.xyz.\n","funding_links":[],"categories":["Makefile"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeso-protocol%2Frun","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeso-protocol%2Frun","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeso-protocol%2Frun/lists"}