{"id":28465986,"url":"https://github.com/doctorlai/simple-steem-docker","last_synced_at":"2026-05-19T03:34:05.738Z","repository":{"id":256548018,"uuid":"855717616","full_name":"DoctorLai/simple-steem-docker","owner":"DoctorLai","description":"The simple steem docker helper utility","archived":false,"fork":false,"pushed_at":"2025-05-03T15:35:18.000Z","size":41,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-03T13:58:08.421Z","etag":null,"topics":["blockchain","docker","steem","steemd","steemit","witness"],"latest_commit_sha":null,"homepage":"https://steemyy.com","language":"Shell","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/DoctorLai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"doctorlai","patreon":"doctorlai","buy_me_a_coffee":"y0BtG5R","thanks_dev":"doctorlai"}},"created_at":"2024-09-11T10:54:57.000Z","updated_at":"2025-05-03T15:35:21.000Z","dependencies_parsed_at":"2024-11-23T11:24:36.638Z","dependency_job_id":"4988a0b3-7ef5-4483-94b2-a743639fb3d1","html_url":"https://github.com/DoctorLai/simple-steem-docker","commit_stats":null,"previous_names":["doctorlai/simple-steem-docker"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/DoctorLai/simple-steem-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DoctorLai%2Fsimple-steem-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DoctorLai%2Fsimple-steem-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DoctorLai%2Fsimple-steem-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DoctorLai%2Fsimple-steem-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DoctorLai","download_url":"https://codeload.github.com/DoctorLai/simple-steem-docker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DoctorLai%2Fsimple-steem-docker/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264343798,"owners_count":23593792,"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":["blockchain","docker","steem","steemd","steemit","witness"],"created_at":"2025-06-07T06:07:58.912Z","updated_at":"2026-05-19T03:34:05.731Z","avatar_url":"https://github.com/DoctorLai.png","language":"Shell","funding_links":["https://github.com/sponsors/doctorlai","https://patreon.com/doctorlai","https://buymeacoffee.com/y0BtG5R","https://thanks.dev/doctorlai"],"categories":[],"sub_categories":[],"readme":"# Docker Steem Witness Node Utility\n\nThis utility script helps manage a Steem witness node using Docker. You can start, stop, restart, force kill, debug, print configuration, check status, and view logs of the witness node container with simple commands.\n\n---\n\n## Requirements\n\n- Docker installed and running  \n- A Steem witness node Docker image (For example: `justyy/steem:ubuntu24.04`). See all images at [justyy/steem](https://hub.docker.com/r/justyy/steem)\n\n---\n\n## Environment Variables\n\nThe following environment variables can be used to customize the behavior of the script. The script respects any environment variable you export before running it. If a variable is not set, the default value will be used.\n\n---\n\n### `DOCKER_NAME`\n\n- **Description:** The name of the Docker container that will run the Steem witness node.  \n- **Default:** `steem`  \n- **Example:**\n\n\u003ccode\u003eexport DOCKER_NAME=\"steem\"\u003c/code\u003e\n\n---\n\n### `DOCKER_IMAGE`\n\n- **Description:** The Docker image that will be used to run the Steem witness node.  \n- **Default:** `steem:latest`  \n- **Example:**\n\n\u003ccode\u003eexport DOCKER_IMAGE=\"steem:latest\"\u003c/code\u003e\n\nYou can pull prebuilt images from [justyy/steem](https://hub.docker.com/r/justyy/steem/tags), for example:\n\n\u003ccode\u003edocker pull justyy/steem:ubuntu24.04\u003c/code\u003e\n\n---\n\n### `LOCAL_STEEM_LOCATION`\n\n- **Description:** The local directory where Steem data will be stored. This directory will be mounted to the Docker container i.e. `/steem`.\n- **Default:** `/root/steem-docker/data/witness_node_data_dir`  \n- **Example:**\n\n\u003ccode\u003eexport LOCAL_STEEM_LOCATION=\"/root/steem-docker\"\u003c/code\u003e\n\n---\n\n### `SEED_PORT` and `API_PORT`\n\n- **SEED_PORT:** Port mapping for the Steem witness node seed port (default `-p 2001:2001`)  \n- **API_PORT:** Port mapping for the HTTP RPC port (default `-p 8091:8091`)  \n\nYou can remove or change these in the script e.g. if you don't want to expose the API port.\n\n---\n\n### `ULIMIT_NUMBER`\n\n- **Description:** Number of file descriptors allowed for the container.  \n- **Default:** `999999`  \n\n\u003e Usually, you don't need to change this value.\n\n---\n\n## Usage\n\nTo customize the behavior of the script, set any of the environment variables listed above before running the script. If you do not set any of the variables, the script will use the default values.\n\n- **DOCKER_NAME:** `steem`  \n- **DOCKER_IMAGE:** `steem:latest`  \n- **LOCAL_STEEM_LOCATION:** `/root/steem-docker/data/witness_node_data_dir`  \n\n---\n\n### Example with Custom Environment Variables\n\n\u003ccode\u003eexport DOCKER_NAME=\"my_steem_node\"\u003c/code\u003e  \n\u003ccode\u003eexport DOCKER_IMAGE=\"custom_steem_image:latest\"\u003c/code\u003e  \n\u003ccode\u003eexport LOCAL_STEEM_LOCATION=\"/mnt/custom_steem_data\"\u003c/code\u003e\n\n---\n\n## Script Commands\n\n### Start the Steem Witness Node\n\n\u003ccode\u003e./run.sh start\u003c/code\u003e\n\n- Starts the Steem witness node in a Docker container.  \n- Maps the following ports by default:\n  - `2001:2001` – Seed port  \n  - `8091:8091` – HTTP RPC port  \n- Mounts Steem data to `$LOCAL_STEEM_LOCATION` on the host.\n\n---\n\n### Stop the Steem Witness Node\n\n\u003ccode\u003e./run.sh stop\u003c/code\u003e\n\n- Stops the Steem witness node container gracefully with a timeout of 600 seconds.  \n- Removes the container after stopping.  \n\n---\n\n### Force Kill the Steem Witness Node\n\n\u003ccode\u003e./run.sh kill\u003c/code\u003e\n\n- Immediately stops the container and removes it, regardless of its state.  \n\n---\n\n### Restart the Steem Witness Node\n\n\u003ccode\u003e./run.sh restart\u003c/code\u003e\n\n- Stops and then starts the container. Equivalent to running:\n\n\u003ccode\u003e./run.sh stop\u003c/code\u003e  \n\u003ccode\u003e./run.sh start\u003c/code\u003e\n\n---\n\n### Start a Test Steem Container\n\n\u003ccode\u003e./run.sh test\u003c/code\u003e\n\n- Starts the container interactively with a `/bin/bash` shell.  \n- Useful for inspecting the container or running commands manually.\n\n---\n\n### Debug the Steem Witness Node\n\n\u003ccode\u003e./run.sh debug\u003c/code\u003e\n\n- Debug the running steem container\n\n---\n\n### Print Current Configuration\n\n\u003ccode\u003e./run.sh print\u003c/code\u003e\n\n- Prints the current parameters used by the script, including:\n  - `DOCKER_NAME`  \n  - `DOCKER_IMAGE`  \n  - `LOCAL_STEEM_LOCATION`  \n  - `SEED_PORT`  \n  - `API_PORT`  \n  - `DOCKER_ARGS`  \n  - `ULIMIT_NUMBER`  \n\n---\n\n### Check Container Status\n\n\u003ccode\u003e./run.sh status\u003c/code\u003e\n\n- Displays detailed container information:\n  - Running state  \n  - Container ID  \n  - Image name  \n  - Ports  \n  - Mounted volumes  \n  - Ulimit and restart policy  \n  - CPU and memory usage  \n\n---\n\n### Wallet Cli\n\n\u003ccode\u003e./run.sh wallet\u003c/code\u003e\n\n- Launch a wallet_cli connected to local steemd at port 8090 (which can be specified in env variable `STEEM_WS_PORT`)\n\n---\n\n### View Logs of the Steem Witness Node\n\n\u003ccode\u003e./run.sh logs\u003c/code\u003e\n\n- Tails the last 100 lines of the container logs by default and follows new entries.  \n- To show a different number of lines:\n\n\u003ccode\u003e./run.sh logs 500\u003c/code\u003e\n\n- To show all:\n\n\u003ccode\u003e./run.sh logs all\u003c/code\u003e\n\n---\n\n### Install Docker\n\n\u003ccode\u003e./run.sh install_docker\u003c/code\u003e\n\n- This is a quick short cut to install the docker.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdoctorlai%2Fsimple-steem-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdoctorlai%2Fsimple-steem-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdoctorlai%2Fsimple-steem-docker/lists"}