59 lines
2.3 KiB
Markdown
59 lines
2.3 KiB
Markdown
# Dogecoin Node Multiarchitecture Docker
|
|
|
|
A Dockerized Dogecoin node built for `linux/amd64` and `linux/arm64` architectures, based on Debian Bookworm. This project provides a lightweight, secure, and automated way to deploy a Dogecoin full node using Docker Buildx and multiarch manifests. Automated builds are triggered on new Dogecoin releases, ensuring up-to-date images pushed to Docker Hub.
|
|
|
|
## Features
|
|
- Multiarchitecture support for seamless deployment on x86_64 and ARM64 platforms.
|
|
- Built from source for compatibility and reliability, using Dogecoin v1.14.9.
|
|
- Automated builds via Gitea Actions, triggered by new upstream Dogecoin releases.
|
|
- Slim Debian-based image with minimal dependencies for efficiency.
|
|
- Configurable data volume and exposed port (22556) for easy integration.
|
|
|
|
## Usage
|
|
Run the Dogecoin node with a persistent data volume:
|
|
|
|
```bash
|
|
docker run -v dogecoin-data:/app/dogecoin -p 22556:22556 myusername/dogecoin-node:latest
|
|
```
|
|
|
|
Options:
|
|
- `-v dogecoin-data:/app/dogecoin`: Persists blockchain data.
|
|
- `-p 22556:22556`: Exposes the Dogecoin P2P port.
|
|
- Add `-e DOGECOIN_VERSION=<version>` to pin a specific version.
|
|
|
|
## Setup
|
|
1. **Pull the Image**:
|
|
```bash
|
|
docker pull myusername/dogecoin-node:latest
|
|
```
|
|
2. **Run the Container**:
|
|
Use the command above to start the node.
|
|
3. **Build Locally** (optional):
|
|
```bash
|
|
docker buildx build --platform linux/amd64,linux/arm64 -t myusername/dogecoin-node:latest --push .
|
|
```
|
|
|
|
## Automation
|
|
This repository uses Gitea Actions to:
|
|
- Check for new Dogecoin releases daily.
|
|
- Build multiarch images for `linux/amd64` and `linux/arm64`.
|
|
- Push images to Docker Hub with a manifest for seamless pulling.
|
|
|
|
See `.gitea/workflows/build-dogecoin.yml` for details.
|
|
|
|
## Contributing
|
|
Contributions are welcome! To contribute:
|
|
1. Fork the repository.
|
|
2. Create a feature branch (`git checkout -b feature/my-feature`).
|
|
3. Commit changes (`git commit -m 'Add my feature'`).
|
|
4. Push to the branch (`git push origin feature/my-feature`).
|
|
5. Open a pull request.
|
|
|
|
Please test changes with `docker buildx` and ensure compatibility with both architectures.
|
|
|
|
## License
|
|
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
|
|
|
|
## Acknowledgments
|
|
- [Dogecoin Project](https://github.com/dogecoin/dogecoin) for the upstream codebase.
|
|
- The Dogecoin community for their open-source contributions. |