Update Epicbox default settings and integration instructions

.gitignore

@@ -0,0 +1,172 @@
+# Please take extra care not to add rules that will make tracked files ignored.
+# To test that, run `git ls-files -i --exclude-standard`.
+# To check why a specific file is ignored, run `git check-ignore -v <filepath>`.
+
+# === Rule for dotfiles ===
+# Ignore all dotfiles.
+.*
+# Exclude specific dotfiles that we want to track.
+!deps/**/.*
+!.devcontainer/
+!.devcontainer/.devcontainer.json
+!test/fixtures/**/.*
+!.clang-format
+!.cpplint
+!.editorconfig
+!.eslintignore
+!.eslintrc.js
+!.eslintrc.yaml
+!.gitattributes
+!.github
+!.gitignore
+!.gitkeep
+!.gitpod.yml
+!.mailmap
+!.nycrc
+!.yamllint.yaml
+
+# === Rules for root dir ===
+/core
+/vgcore.*
+/v8*.log
+/perf.data
+/perf.data.old
+/tags
+/tags.*
+/doc/api.xml
+/node
+/node_g
+/gon-config.json
+/*.exe
+/*.swp
+/out
+/*.msi
+/*.wixpdb
+/*.qlog
+# For GitHub Codespaces
+/pythonenv*
+
+# === Rules for artifacts of `./configure` ===
+/icu_config.gypi
+/config.gypi
+/config.status
+/config_fips.gypi
+
+# === Rules for MSVS artifacts ===
+Debug/
+Release/
+*.sln
+*.suo
+*.vcxproj*
+UpgradeLog*.XML
+_UpgradeReport_Files/
+*.sdf
+*.opensdf
+*.VC.*
+*.wixobj
+/tools/msvs/genfiles/
+/npm.wxs
+/corepack.wxs
+/tools/msvs/msi/**/Release/
+/tools/msvs/msi/**/obj/
+/tools/msvs/msi/**/x64/
+# Exclude MSVS files used for .msi file generation
+!tools/msvs/msi/**/custom_actions.vcxproj
+!tools/msvs/msi/**/nodemsi.sln
+
+# === Rules for GYP artifacts ===
+*-nodegyp*
+/gyp-*-tool
+/test/addons/??_*/
+/*.mk
+
+# === Rules for other build artifacts ===
+/email.md
+/deps/v8-*
+/deps/icu
+/deps/icu*.zip
+/deps/icu*.tgz
+/deps/icu-tmp
+./node_modules
+/android-toolchain/
+# generated by gyp on Windows
+/deps/openssl/openssl.props
+/deps/openssl/openssl.targets
+/deps/openssl/openssl.xml
+/deps/openssl/openssl-fipsmodule.props
+/deps/openssl/openssl-fipsmodule.targets
+/deps/openssl/openssl-fipsmodule.xml
+# generated by gyp on android
+/*.target.mk
+/*.host.mk
+/deps/openssl/openssl.target.mk
+/deps/zlib/zlib.target.mk
+# generated by MSVC with /P enabled
+tools/*/*.i
+tools/*/*.i.tmp
+
+# === Rules for release artifacts ===
+/*.tar.*
+/*.pkg
+/SHASUMS*.txt*
+
+# === Rules for `node_modules` ===
+!**/node_modules/**
+/node_modules
+/tools/doc/node_modules
+/tools/clang-format/node_modules
+
+# === Rules for test artifacts ===
+/*.tap
+/*.xml
+/v8*-tap.json
+/node_trace.*.log
+# coverage related
+/gcovr
+/build
+/coverage
+
+# === Rules for Xcode artifacts ===
+*.xcodeproj
+*.xcworkspace
+*.pbxproj
+
+# === Rules for files in `/deps` ===
+# Exclude all files in the vendored `npm`.
+!/deps/npm/node_modules
+# These are not needed and causes issues for distro packagers.
+/deps/npm/node_modules/.bin/
+# Respect V8's .gitignore
+!deps/v8/**
+# Ignore the libuv book
+/deps/uv/docs/code/
+/deps/uv/docs/src/guide/
+# Ignore .github directories
+/deps/**/.github/
+# Ignore dependencies fetched by tools/v8/fetch_deps.py
+/deps/.cipd
+
+# === Rules for Windows vcbuild.bat ===
+/temp-vcbuild
+
+# === Rules for CMake ===
+cmake-build-debug/
+CMakeCache.txt
+CMakeFiles
+CTestTestfile.cmake
+cmake_install.cmake
+install_manifest.txt
+*.cbp
+
+# === Global Rules ===
+# Keep last to avoid being excluded
+*.pyc
+__pycache__
+.DS_Store
+*~
+
+# === Rules for C++ development ===
+compile_commands.json
+
+epicboxlib_source/target
+config.json

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "epicboxlib_source/epic-wallet"]
+	path = epicboxlib_source/epic-wallet
+	url = https://github.com/EpicCash/epic-wallet.git

README.md

@@ -1,18 +1,109 @@
+## Nginx Passthrough/Proxy Example
+
+To expose your Epicbox Docker service securely on your own domain, use a simple nginx reverse proxy. This allows you to use SSL and a custom domain name.
+
+### 1. Start Epicbox Docker with Custom Domain
+
+```sh
+EPICBOX_DOMAIN=your-epicbox-domain.example docker compose up -d --build
+```
+
+### 2. Example nginx Reverse Proxy Configuration
+
+Place this in your nginx config (e.g., `/etc/nginx/sites-available/epicbox.conf`):
+
+```
+upstream epicbox_backend {
+  ip_hash;
+  server 127.0.0.1:8888 max_fails=3 fail_timeout=10s;
+  server 127.0.0.1:8889 max_fails=3 fail_timeout=10s;
+}
+server {
+	server_name your-epicbox-domain.example www.your-epicbox-domain.example;
+
+	root /var/www/html/epicbox/;
+	index index.html index.htm;
+
+	location / {
+		proxy_set_header        Host $host;
+		proxy_set_header        X-Real-IP $remote_addr;
+		proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
+		proxy_set_header        X-Forwarded-Proto $scheme;
+
+		proxy_pass http://epicbox_backend;
+		proxy_read_timeout  90;
+
+		# WebSocket support
+		proxy_http_version 1.1;
+		proxy_set_header Upgrade $http_upgrade;
+		proxy_set_header Connection "upgrade";
+	}
+
+	access_log /var/log/nginx/epicbox.access.log;
+	error_log /var/log/nginx/epicbox.error.log;
+
+	listen 443 ssl;
+	ssl_certificate /etc/letsencrypt/live/your-epicbox-domain.example/fullchain.pem;
+	ssl_certificate_key /etc/letsencrypt/live/your-epicbox-domain.example/privkey.pem;
+	include /etc/letsencrypt/options-ssl-nginx.conf;
+	ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;
+}
+```
+
+- Replace `your-epicbox-domain.example` with your actual domain.
+- Adjust SSL certificate paths as needed.
+
+### 3. Reload nginx
+
+```sh
+sudo nginx -s reload
+```
+
+Now, your domain will securely proxy to your Epicbox Docker service!
 # epicboxnodejs
-Epicbox version on nodejs with elements of rust and adopt changes in epicbox protocole.
 
-Added app_mongo_many.js for run many isntances under one domain. Each instance need use the same mongo database, in all instances adopted fastsend method.
-For fastsend method only one of instances must have in config_many.json set fast_send_master=true, slaves ips must be set in array fast_send_slaves.
-All instances must have the same epicbox domain and epicbox port set ( correct to your used epicbox.domain ).
+Epicbox Relay Server for Epic Cash, built with Node.js and Rust.
+
+## Docker Quick Start
+
+1. **Clone the repository and initialize submodules:**
+	```sh
+	git clone <repo-url>
+	cd epicboxnodejs-source
+	git submodule update --init --recursive
+	```
+
+2. **Build and start all services with Docker Compose:**
+	```sh
+	docker compose up -d --build
+	```
+
+3. **Custom configuration via environment variables:**
+	You can override key settings at runtime:
+	```sh
+	EPICBOX_DOMAIN=my.domain.com docker compose up -d --build
+	```
+	- `EPICBOX_DOMAIN`: Sets the domain for epicbox services (default: epicbox.your-domain.com)
+	- `EPICBOX_PORT`: Sets the port for epicbox services (default: 443)
+	- `NGINX_PORT`: Sets the external port for nginx (default: 8443)
+
+4. **Access the service:**
+	- Open `http://localhost:8443` (or your chosen NGINX_PORT) in your browser.
 
-Instance with set fast_send_master = true can work like independent alone epicbox ( like preverious version app_mongo.js ).
+5. **Scaling and failover:**
+	- Two epicbox instances are started by default (epicbox1 and epicbox2).
+	- nginx will automatically route requests to available instances.
 
-For each instance so you must use diffirent config_many.json file ( set other local port, or fast_send_master = false etc. ) so to run epicbox use command:
+## Configuration Reference
 
-node app_mongo_many.js config_many.json
+All major settings can be configured via environment variables or a `.env` file:
 
-And for next one:
+```
+EPICBOX_DOMAIN=my.domain.com
+EPICBOX_PORT=443
+```
 
-node app_mongo_many.js config_many_slave1.json
+## Advanced
 
-Enjoy.
+- MongoDB, nginx, and epicbox instances are all managed via `docker-compose.yml`.
+- For custom setups, edit `docker-compose.yml` and `default_config.json` as needed.