@@ -677,10 +677,7 @@ <h4>Docker Guide</h4>
677677 < a href ="#overview "> Overview</ a >
678678 < a href ="#cli-deployment "> CLI Docker Deployment</ a >
679679 < a href ="#web-deployment "> Web Docker Deployment</ a >
680- < a href ="#persistent-storage "> Persistent Storage</ a >
681680 < a href ="#container-management "> Container Management</ a >
682- < a href ="#production-setup "> Production Setup</ a >
683- < a href ="#troubleshooting "> Troubleshooting</ a >
684681 </ aside >
685682
686683 <!-- Content -->
@@ -816,27 +813,6 @@ <h2>Web Deployment</h2>
816813 < p > WORKING ON THIS FEATURE</ p >
817814 </ section >
818815
819- <!-- Persistent Storage -->
820- < section id ="persistent-storage " class ="doc-section ">
821- < h2 > Persistent Storage</ h2 >
822- < p > Configure persistent storage for your CoreSecurityFramework data and configurations.</ p >
823-
824- < div class ="code-snippet ">
825- < pre > < code > # Create named volumes
826- docker volume create coresec_data
827- docker volume create coresec_config
828-
829- # Run with persistent storage
830- docker run -d \
831- -p 8080:8080 \
832- -p 6080:6080 \
833- -v coresec_data:/opt/coresecframe/data \
834- -v coresec_config:/opt/coresecframe/config \
835- --name coresecframe \
836- coresecframe</ code > </ pre >
837- </ div >
838- </ section >
839-
840816 <!-- Container Management -->
841817 < section id ="container-management " class ="doc-section ">
842818 < h2 > Container Management</ h2 >
@@ -916,142 +892,6 @@ <h4>Updates & Maintenance</h4>
916892 </ div >
917893 </ section >
918894
919- <!-- Production Setup -->
920- < section id ="production-setup " class ="doc-section ">
921- < h2 > Production Setup</ h2 >
922- < p > Best practices for deploying CoreSecurityFramework in production environments.</ p >
923-
924- < div class ="code-snippet ">
925- < pre > < code > # Production deployment with all recommended settings
926- docker run -d \
927- --name coresecframe-prod \
928- --restart=unless-stopped \
929- --memory="4g" \
930- --cpus="2" \
931- -p 8080:8080 \
932- -p 6080:6080 \
933- -v coresec_data:/opt/coresecframe/data \
934- -v coresec_config:/opt/coresecframe/config \
935- -v /var/log/coresecframe:/opt/coresecframe/logs \
936- -e CORESEC_DEBUG=false \
937- -e CORESEC_AUTO_UPDATE=false \
938- coresecframe</ code > </ pre >
939- </ div >
940- </ section >
941-
942- <!-- Troubleshooting -->
943- < section id ="troubleshooting " class ="doc-section ">
944- < h2 > Docker Troubleshooting</ h2 >
945- < p > Common Docker-related issues and their solutions.</ p >
946-
947- < div class ="troubleshooting-items ">
948- < div class ="trouble-item ">
949- < h4 > < i class ="fas fa-exclamation-triangle "> </ i > Container Won't Start</ h4 >
950- < p > < strong > Symptoms:</ strong > Container exits immediately or fails to start</ p >
951- < div class ="trouble-solutions ">
952- < h5 > Check Docker Logs</ h5 >
953- < div class ="code-snippet ">
954- < pre > < code > docker logs coresecframe</ code > </ pre >
955- </ div >
956- < h5 > Verify Port Availability</ h5 >
957- < div class ="code-snippet ">
958- < pre > < code > # Check if ports are in use
959- netstat -tulpn | grep :8080
960- netstat -tulpn | grep :6080
961-
962- # Use different ports if needed
963- docker run -p 9080:8080 -p 7080:6080 ...</ code > </ pre >
964- </ div >
965- < h5 > Check System Resources</ h5 >
966- < div class ="code-snippet ">
967- < pre > < code > # Check available memory
968- free -h
969-
970- # Check disk space
971- df -h</ code > </ pre >
972- </ div >
973- </ div >
974- </ div >
975-
976- < div class ="trouble-item ">
977- < h4 > < i class ="fas fa-network-wired "> </ i > Network Connectivity Issues</ h4 >
978- < p > < strong > Symptoms:</ strong > Cannot access web interfaces or container networking problems</ p >
979- < div class ="trouble-solutions ">
980- < h5 > Verify Port Mapping</ h5 >
981- < div class ="code-snippet ">
982- < pre > < code > # Check port mappings
983- docker port coresecframe
984-
985- # Test local connectivity
986- curl -I http://localhost:8080</ code > </ pre >
987- </ div >
988- < h5 > Check Firewall Settings</ h5 >
989- < div class ="code-snippet ">
990- < pre > < code > # Ubuntu/Debian
991- sudo ufw status
992- sudo ufw allow 8080
993- sudo ufw allow 6080
994-
995- # CentOS/RHEL
996- sudo firewall-cmd --list-ports
997- sudo firewall-cmd --add-port=8080/tcp --permanent
998- sudo firewall-cmd --add-port=6080/tcp --permanent</ code > </ pre >
999- </ div >
1000- </ div >
1001- </ div >
1002-
1003- < div class ="trouble-item ">
1004- < h4 > < i class ="fas fa-memory "> </ i > Performance Issues</ h4 >
1005- < p > < strong > Symptoms:</ strong > Slow container performance or out of memory errors</ p >
1006- < div class ="trouble-solutions ">
1007- < h5 > Increase Resource Limits</ h5 >
1008- < div class ="code-snippet ">
1009- < pre > < code > # Run with more resources
1010- docker run -d \
1011- --memory="4g" \
1012- --cpus="2" \
1013- -p 8080:8080 \
1014- -p 6080:6080 \
1015- coresecframe</ code > </ pre >
1016- </ div >
1017- < h5 > Monitor Resource Usage</ h5 >
1018- < div class ="code-snippet ">
1019- < pre > < code > # Check real-time stats
1020- docker stats coresecframe
1021-
1022- # Check container processes
1023- docker exec coresecframe top</ code > </ pre >
1024- </ div >
1025- </ div >
1026- </ div >
1027-
1028- < div class ="trouble-item ">
1029- < h4 > < i class ="fas fa-desktop "> </ i > VNC/noVNC Issues</ h4 >
1030- < p > < strong > Symptoms:</ strong > Remote desktop not working or display issues</ p >
1031- < div class ="trouble-solutions ">
1032- < h5 > Check VNC Services</ h5 >
1033- < div class ="code-snippet ">
1034- < pre > < code > # Check if VNC processes are running
1035- docker exec coresecframe ps aux | grep vnc
1036- docker exec coresecframe ps aux | grep Xvfb
1037-
1038- # Restart VNC services
1039- docker exec coresecframe pkill -f vnc
1040- docker exec coresecframe pkill -f Xvfb
1041- docker restart coresecframe</ code > </ pre >
1042- </ div >
1043- < h5 > Test VNC Connection</ h5 >
1044- < div class ="code-snippet ">
1045- < pre > < code > # Check if VNC port is listening
1046- docker exec coresecframe netstat -tulpn | grep :5900
1047-
1048- # Test websockify
1049- docker exec coresecframe netstat -tulpn | grep :6080</ code > </ pre >
1050- </ div >
1051- </ div >
1052- </ div >
1053- </ div >
1054-
1055895 < div class ="troubleshooting-tips ">
1056896 < h4 > General Troubleshooting Tips</ h4 >
1057897 < ul >
0 commit comments