2022-02-05 06:30:33 +00:00
<!DOCTYPE html>
< html lang = "en-US" >
< head >
< meta charset = 'utf-8' >
< meta http-equiv = "X-UA-Compatible" content = "chrome=1" >
< meta name = "viewport" content = "width=device-width, initial-scale=1" >
< link rel = "icon" type = "image/png" sizes = "16x16" href = "/enigma-bbs/assets/images/favicon-16x16.png" >
< link rel = "icon" type = "image/png" sizes = "32x32" href = "/enigma-bbs/assets/images/favicon-32x32.png" >
< link rel = "icon" type = "image/png" sizes = "32x32" href = "/enigma-bbs/assets/images/favicon-32x32.png" >
< link rel = "stylesheet" href = "/enigma-bbs/assets/css/style.css?v=" >
<!-- Begin Jekyll SEO tag v2.7.1 -->
< title > Docker | ENiGMA½ BBS Software< / title >
< meta name = "generator" content = "Jekyll v4.2.1" / >
< meta property = "og:title" content = "Docker" / >
< meta property = "og:locale" content = "en_US" / >
2022-08-19 06:04:01 +00:00
< meta name = "description" content = ":warning: You’ / >
< meta property = "og:description" content = ":warning: You’ / >
2022-02-05 06:30:33 +00:00
< meta property = "og:site_name" content = "ENiGMA½ BBS Software" / >
< meta property = "og:type" content = "article" / >
2022-09-09 03:31:36 +00:00
< meta property = "article:published_time" content = "2022-09-09T03:31:32+00:00" / >
2022-02-05 06:30:33 +00:00
< meta name = "twitter:card" content = "summary" / >
< meta property = "twitter:title" content = "Docker" / >
< script type = "application/ld+json" >
2022-09-09 03:31:36 +00:00
{"datePublished":"2022-09-09T03:31:32+00:00","description":":warning: You’ < / script >
2022-02-05 06:30:33 +00:00
<!-- End Jekyll SEO tag -->
< / head >
< body >
< div id = "container" >
< div class = "sidebar" id = "sidebar" >
< hr class = "mobile-divide" >
< div class = "container" >
< a href = "/enigma-bbs/" > < img src = "/enigma-bbs/assets/images/enigma-logo.png" class = "logo" alt = "Enigma logo" > < / a >
< / div >
< ul >
< li > Installation< / li >
< ul >
< li > < a href = "/enigma-bbs/installation/installation-methods.html" > Installation Methods< / a > < / li >
< li > < a href = "/enigma-bbs/installation/install-script.html" > Install Script< / a > < / li >
< li class = "active-nav" > Docker< / li >
< li > < a href = "/enigma-bbs/installation/manual.html" > Manual Installation< / a > < / li >
< li > OS / Hardware Specific< / li >
< ul >
< li > < a href = "/enigma-bbs/installation/hardware/rpi.html" > Raspberry Pi< / a > < / li >
< li > < a href = "/enigma-bbs/installation/hardware/windows.html" > Installation Under Windows< / a > < / li >
< / ul >
< li > < a href = "/enigma-bbs/installation/network.html" > Network Setup< / a > < / li >
< li > < a href = "/enigma-bbs/installation/testing.html" > Testing Your Installation< / a > < / li >
< li > < a href = "/enigma-bbs/installation/production.html" > Production Installation< / a > < / li >
< / ul >
< li > Configuration< / li >
< ul >
< li > < a href = "/enigma-bbs/configuration/creating-config.html" > Creating Initial Config Files< / a > < / li >
< li > < a href = "/enigma-bbs/configuration/sysop-setup.html" > SysOp Setup< / a > < / li >
< li > < a href = "/enigma-bbs/configuration/config-files.html" > Configuration Files< / a > < / li >
< li > < a href = "/enigma-bbs/configuration/config-hjson.html" > System Configuration< / a > < / li >
< li > < a href = "/enigma-bbs/configuration/hjson.html" > HJSON Config Files< / a > < / li >
< li > < a href = "/enigma-bbs/configuration/menu-hjson.html" > Menu HSJON< / a > < / li >
< li > < a href = "/enigma-bbs/configuration/directory-structure.html" > Directory Structure< / a > < / li >
< li > < a href = "/enigma-bbs/configuration/external-binaries.html" > External Support Binaries< / a > < / li >
< li > < a href = "/enigma-bbs/configuration/archivers.html" > Archivers< / a > < / li >
< li > < a href = "/enigma-bbs/configuration/file-transfer-protocols.html" > File Transfer Protocols< / a > < / li >
< li > < a href = "/enigma-bbs/configuration/email.html" > Email< / a > < / li >
< li > < a href = "/enigma-bbs/configuration/colour-codes.html" > Colour Codes< / a > < / li >
< li > < a href = "/enigma-bbs/configuration/event-scheduler.html" > Event Scheduler< / a > < / li >
< li > < a href = "/enigma-bbs/configuration/acs.html" > Access Condition System (ACS)< / a > < / li >
< li > < a href = "/enigma-bbs/configuration/security.html" > Security< / a > < / li >
< / ul >
< li > Miscellaneous< / li >
< ul >
< li > < a href = "/enigma-bbs/misc/user-interrupt.html" > User Interruptions< / a > < / li >
< / ul >
< li > File Base< / li >
< ul >
< li > < a href = "/enigma-bbs/filebase/index.html" > About File Areas< / a > < / li >
< li > < a href = "/enigma-bbs/filebase/first-file-area.html" > Configuring a File Base< / a > < / li >
< li > < a href = "/enigma-bbs/filebase/acs.html" > ACS< / a > < / li >
< li > < a href = "/enigma-bbs/filebase/uploads.html" > Uploads< / a > < / li >
< li > < a href = "/enigma-bbs/filebase/web-access.html" > Web Access< / a > < / li >
< li > < a href = "/enigma-bbs/filebase/tic-support.html" > TIC Support< / a > < / li >
< li > < a href = "/enigma-bbs/filebase/network-mounts-and-symlinks.html" > Network Mounts & Symlinks< / a > < / li >
< / ul >
< li > Message Areas< / li >
< ul >
< li > < a href = "/enigma-bbs/messageareas/configuring-a-message-area.html" > Message Base< / a > < / li >
< li > < a href = "/enigma-bbs/messageareas/message-networks.html" > Message Networks< / a > < / li >
< li > < a href = "/enigma-bbs/messageareas/bso-import-export.html" > BSO Import / Export< / a > < / li >
< li > < a href = "/enigma-bbs/messageareas/netmail.html" > Netmail< / a > < / li >
< li > < a href = "/enigma-bbs/messageareas/qwk.html" > QWK Support< / a > < / li >
< li > < a href = "/enigma-bbs/messageareas/ftn.html" > FidoNet-Style Networks (FTN)< / a > < / li >
< / ul >
< li > Art< / li >
< ul >
< li > < a href = "/enigma-bbs/art/general.html" > General Art Information< / a > < / li >
< li > < a href = "/enigma-bbs/art/themes.html" > Themes< / a > < / li >
< li > < a href = "/enigma-bbs/art/mci.html" > MCI Codes< / a > < / li >
< li > Views< / li >
< ul >
< li > < a href = "/enigma-bbs/art/views/button_view.html" > Button View< / a > < / li >
< li > < a href = "/enigma-bbs/art/views/edit_text_view.html" > Edit Text View< / a > < / li >
< li > < a href = "/enigma-bbs/art/views/full_menu_view.html" > Full Menu View< / a > < / li >
< li > < a href = "/enigma-bbs/art/views/horizontal_menu_view.html" > Horizontal Menu View< / a > < / li >
< li > < a href = "/enigma-bbs/art/views/mask_edit_text_view.html" > Mask Edit Text View< / a > < / li >
< li > < a href = "/enigma-bbs/art/views/multi_line_edit_text_view.html" > Multi Line Edit Text View< / a > < / li >
< li > < a href = "/enigma-bbs/art/views/predefined_label_view.html" > Predefined Label View< / a > < / li >
< li > < a href = "/enigma-bbs/art/views/spinner_menu_view.html" > Spinner Menu View< / a > < / li >
< li > < a href = "/enigma-bbs/art/views/text_view.html" > Text View< / a > < / li >
< li > < a href = "/enigma-bbs/art/views/toggle_menu_view.html" > Toggle Menu View< / a > < / li >
< li > < a href = "/enigma-bbs/art/views/vertical_menu_view.html" > Vertical Menu View< / a > < / li >
< / ul >
< / ul >
< li > Servers< / li >
< ul >
< li > Login Servers< / li >
< ul >
< li > < a href = "/enigma-bbs/servers/loginservers/telnet.html" > Telnet Server< / a > < / li >
< li > < a href = "/enigma-bbs/servers/loginservers/ssh.html" > SSH Server< / a > < / li >
< li > < a href = "/enigma-bbs/servers/loginservers/websocket.html" > Web Socket / Web Interface Server< / a > < / li >
< / ul >
< li > Content Servers< / li >
< ul >
< li > < a href = "/enigma-bbs/servers/contentservers/web-server.html" > Web Server< / a > < / li >
< li > < a href = "/enigma-bbs/servers/contentservers/gopher.html" > Gopher Server< / a > < / li >
< li > < a href = "/enigma-bbs/servers/contentservers/nntp.html" > NNTP Server< / a > < / li >
< / ul >
< / ul >
< li > Modding< / li >
< ul >
< li > < a href = "/enigma-bbs/modding/local-doors.html" > Local Doors< / a > < / li >
< li > < a href = "/enigma-bbs/modding/door-servers.html" > Door Servers< / a > < / li >
< li > < a href = "/enigma-bbs/modding/telnet-bridge.html" > Telnet Bridge< / a > < / li >
< li > < a href = "/enigma-bbs/modding/existing-mods.html" > Existing Mods< / a > < / li >
< li > < a href = "/enigma-bbs/modding/file-area-list.html" > File Area List< / a > < / li >
< li > < a href = "/enigma-bbs/modding/last-callers.html" > Last Callers< / a > < / li >
< li > < a href = "/enigma-bbs/modding/whos-online.html" > Who's Online< / a > < / li >
< li > < a href = "/enigma-bbs/modding/user-list.html" > User List< / a > < / li >
< li > < a href = "/enigma-bbs/modding/msg-conf-list.html" > Message Conference List< / a > < / li >
< li > < a href = "/enigma-bbs/modding/msg-area-list.html" > Message Area List< / a > < / li >
< li > < a href = "/enigma-bbs/modding/bbs-list.html" > BBS List< / a > < / li >
< li > < a href = "/enigma-bbs/modding/rumorz.html" > Rumorz< / a > < / li >
< li > < a href = "/enigma-bbs/modding/file-transfer-protocol-select.html" > File Transfer Protocol Select< / a > < / li >
< li > < a href = "/enigma-bbs/modding/onelinerz.html" > Onelinerz< / a > < / li >
< li > < a href = "/enigma-bbs/modding/show-art.html" > The Show Art Module< / a > < / li >
< li > < a href = "/enigma-bbs/modding/file-base-download-manager.html" > File Base Download Manager< / a > < / li >
< li > < a href = "/enigma-bbs/modding/file-base-web-download-manager.html" > File Base Web Download Manager< / a > < / li >
< li > < a href = "/enigma-bbs/modding/set-newscan-date.html" > Set Newscan Date Module< / a > < / li >
< li > < a href = "/enigma-bbs/modding/node-msg.html" > Node to Node Messaging< / a > < / li >
< li > < a href = "/enigma-bbs/modding/top-x.html" > TopX< / a > < / li >
< li > < a href = "/enigma-bbs/modding/user-2fa-otp-config.html" > 2FA/OTP Config< / a > < / li >
< li > < a href = "/enigma-bbs/modding/autosig-edit.html" > Auto Signature Editor< / a > < / li >
< li > < a href = "/enigma-bbs/modding/menu-modules.html" > Menu Modules< / a > < / li >
< / ul >
< li > Administration< / li >
< ul >
< li > < a href = "/enigma-bbs/admin/administration.html" > Administration< / a > < / li >
2022-08-31 03:27:30 +00:00
< / ul >
< li > Modding< / li >
< ul >
2022-02-05 06:30:33 +00:00
2022-08-31 03:27:30 +00:00
< li > < a href = "/enigma-bbs/modding/wfc.html" > Waiting For Caller (WFC)< / a > < / li >
2022-02-05 06:30:33 +00:00
2022-08-31 03:27:30 +00:00
< / ul >
< li > Administration< / li >
< ul >
2022-02-05 06:30:33 +00:00
2022-08-31 03:27:30 +00:00
< li > < a href = "/enigma-bbs/admin/oputil.html" > oputil< / a > < / li >
2022-02-05 06:30:33 +00:00
2022-08-31 03:27:30 +00:00
< li > < a href = "/enigma-bbs/admin/updating.html" > Updating< / a > < / li >
2022-02-05 06:30:33 +00:00
2022-08-04 18:38:39 +00:00
< / ul >
2022-08-31 03:27:30 +00:00
< li > Troubleshooting< / li >
2022-08-04 18:38:39 +00:00
< ul >
2022-08-31 03:27:30 +00:00
< li > < a href = "/enigma-bbs/troubleshooting/monitoring-logs.html" > Monitoring Logs< / a > < / li >
2022-08-04 18:38:39 +00:00
2022-02-05 06:30:33 +00:00
< / ul >
< / ul >
< / div >
< div class = "main_area" >
< div class = "container" >
< section id = "main_content" >
< div class = "PageNavigation" >
< a class = "btn" style = "float:left;margin-right: 20px;" href = "/enigma-bbs/installation/install-script.html" > « Install Script< / a >
< a href = "#sidebar" class = "btn menu_button" > MENU< / a >
< a class = "btn" style = "float: right;margin-left: 20px" href = "/enigma-bbs/installation/manual.html" > Manual Installation »< / a >
< br clear = "both" >
< / div >
< div class = "page" >
< h1 class = "page-title" > Docker< / h1 >
2022-08-19 06:04:01 +00:00
< blockquote >
< p > < img class = "emoji" title = ":warning:" alt = ":warning:" src = "https://github.githubassets.com/images/icons/emoji/unicode/26a0.png" height = "20" width = "20" > < strong > You’
2022-02-05 06:30:33 +00:00
for every operating system on the < a href = "https://docs.docker.com/engine/install/" > Docker website< / a > .< / strong > < / p >
2022-08-19 06:04:01 +00:00
< / blockquote >
2022-02-05 06:30:33 +00:00
< h2 id = "quick-start" > Quick Start< / h2 >
2022-08-19 06:04:01 +00:00
< p > Prepare a folder where you are going to save your bbs files.< / p >
< ol >
2022-02-05 06:30:33 +00:00
< li > Generate some config for your BBS: < br >
2022-08-19 06:04:01 +00:00
You can perform this step from anywhere - but make sure to consistently run it from the same place to retain your config inside the docker guest.< / li >
< / ol >
< div class = "language-bash highlighter-rouge" > < div class = "highlight" > < pre class = "highlight" > < code > docker run < span class = "nt" > -it< / span > < span class = "nt" > -p< / span > 8888:8888 < span class = "se" > \< / span >
< span class = "nt" > --name< / span > < span class = "s2" > "ENiGMABBS"< / span > < span class = "se" > \< / span >
< span class = "nt" > -v< / span > < span class = "s2" > "< / span > < span class = "si" > $(< / span > < span class = "nb" > pwd< / span > < span class = "si" > )< / span > < span class = "s2" > /config:/enigma-bbs/config"< / span > < span class = "se" > \< / span >
< span class = "nt" > -v< / span > < span class = "s2" > "< / span > < span class = "si" > $(< / span > < span class = "nb" > pwd< / span > < span class = "si" > )< / span > < span class = "s2" > /db:/enigma-bbs/db"< / span > < span class = "se" > \< / span >
< span class = "nt" > -v< / span > < span class = "s2" > "< / span > < span class = "si" > $(< / span > < span class = "nb" > pwd< / span > < span class = "si" > )< / span > < span class = "s2" > /logs:/enigma-bbs/logs"< / span > < span class = "se" > \< / span >
< span class = "nt" > -v< / span > < span class = "s2" > "< / span > < span class = "si" > $(< / span > < span class = "nb" > pwd< / span > < span class = "si" > )< / span > < span class = "s2" > /filebase:/enigma-bbs/filebase"< / span > < span class = "se" > \< / span >
< span class = "nt" > -v< / span > < span class = "s2" > "< / span > < span class = "si" > $(< / span > < span class = "nb" > pwd< / span > < span class = "si" > )< / span > < span class = "s2" > /art:/enigma-bbs/art"< / span > < span class = "se" > \< / span >
< span class = "nt" > -v< / span > < span class = "s2" > "< / span > < span class = "si" > $(< / span > < span class = "nb" > pwd< / span > < span class = "si" > )< / span > < span class = "s2" > /mods:/enigma-bbs/mods"< / span > < span class = "se" > \< / span >
< span class = "nt" > -v< / span > < span class = "s2" > "< / span > < span class = "si" > $(< / span > < span class = "nb" > pwd< / span > < span class = "si" > )< / span > < span class = "s2" > /mail:/mail"< / span > < span class = "se" > \< / span >
2022-02-05 06:30:33 +00:00
enigmabbs/enigma-bbs:latest
2022-08-19 06:04:01 +00:00
< / code > < / pre > < / div > < / div >
< ol >
2022-02-05 06:30:33 +00:00
< li > Run it: < br >
2022-08-19 06:04:01 +00:00
You can use the same command as above, just daemonize and drop interactiveness (we needed it for config but most of the time docker will run in the background)< / li >
< / ol >
< div class = "language-bash highlighter-rouge" > < div class = "highlight" > < pre class = "highlight" > < code > docker run < span class = "nt" > -d< / span > < span class = "nt" > -p< / span > 8888:8888 < span class = "se" > \< / span >
< span class = "nt" > --name< / span > < span class = "s2" > "ENiGMABBS"< / span > < span class = "se" > \< / span >
< span class = "nt" > -v< / span > < span class = "s2" > "< / span > < span class = "si" > $(< / span > < span class = "nb" > pwd< / span > < span class = "si" > )< / span > < span class = "s2" > /config:/enigma-bbs/config"< / span > < span class = "se" > \< / span >
< span class = "nt" > -v< / span > < span class = "s2" > "< / span > < span class = "si" > $(< / span > < span class = "nb" > pwd< / span > < span class = "si" > )< / span > < span class = "s2" > /db:/enigma-bbs/db"< / span > < span class = "se" > \< / span >
< span class = "nt" > -v< / span > < span class = "s2" > "< / span > < span class = "si" > $(< / span > < span class = "nb" > pwd< / span > < span class = "si" > )< / span > < span class = "s2" > /logs:/enigma-bbs/logs"< / span > < span class = "se" > \< / span >
< span class = "nt" > -v< / span > < span class = "s2" > "< / span > < span class = "si" > $(< / span > < span class = "nb" > pwd< / span > < span class = "si" > )< / span > < span class = "s2" > /filebase:/enigma-bbs/filebase"< / span > < span class = "se" > \< / span >
< span class = "nt" > -v< / span > < span class = "s2" > "< / span > < span class = "si" > $(< / span > < span class = "nb" > pwd< / span > < span class = "si" > )< / span > < span class = "s2" > /art:/enigma-bbs/art"< / span > < span class = "se" > \< / span >
< span class = "nt" > -v< / span > < span class = "s2" > "< / span > < span class = "si" > $(< / span > < span class = "nb" > pwd< / span > < span class = "si" > )< / span > < span class = "s2" > /mods:/enigma-bbs/mods"< / span > < span class = "se" > \< / span >
< span class = "nt" > -v< / span > < span class = "s2" > "< / span > < span class = "si" > $(< / span > < span class = "nb" > pwd< / span > < span class = "si" > )< / span > < span class = "s2" > /mail:/mail"< / span > < span class = "se" > \< / span >
2022-02-05 06:30:33 +00:00
enigmabbs/enigma-bbs:latest
2022-08-19 06:04:01 +00:00
< / code > < / pre > < / div > < / div >
< h3 id = "restarting-and-making-changes" > Restarting and Making changes\< / h3 >
< p > If you make any changes to your host config folder they will persist, and you can just restart ENiGMABBS container to load any changes you’ < / p >
2022-02-05 06:30:33 +00:00
< p > < code class = "language-plaintext highlighter-rouge" > docker restart ENiGMABBS< / code > < / p >
2022-08-04 18:38:39 +00:00
< blockquote >
< p > < img class = "emoji" title = ":bulb:" alt = ":bulb:" src = "https://github.githubassets.com/images/icons/emoji/unicode/1f4a1.png" height = "20" width = "20" > Configuration will be stored in < code class = "language-plaintext highlighter-rouge" > $(pwd)/enigma-bbs/config< / code > .< / p >
< / blockquote >
2022-02-05 06:30:33 +00:00
2022-08-04 18:38:39 +00:00
< blockquote >
< p > < img class = "emoji" title = ":bulb:" alt = ":bulb:" src = "https://github.githubassets.com/images/icons/emoji/unicode/1f4a1.png" height = "20" width = "20" > Windows users - you’ < code class = "language-plaintext highlighter-rouge" > $(pwd)/enigma-bbs/config< / code > for a Windows-style path.< / p >
< / blockquote >
2022-02-05 06:30:33 +00:00
< h2 id = "volumes" > Volumes< / h2 >
2022-08-04 18:38:39 +00:00
< p > Containers by their nature are ephermeral. Meaning, stuff you want to keep (config, database, mail) needs
2022-02-05 06:30:33 +00:00
to be stored outside of the running container. As such, the following volumes are mountable:< / p >
< table >
< thead >
< tr >
< th style = "text-align: left" > Volume< / th >
< th style = "text-align: left" > Usage< / th >
< / tr >
< / thead >
< tbody >
< tr >
< td style = "text-align: left" > /enigma-bbs/art< / td >
< td style = "text-align: left" > Art, themes, etc< / td >
< / tr >
< tr >
< td style = "text-align: left" > /enigma-bbs/config< / td >
< td style = "text-align: left" > Config such as config.hjson, menu.hjson, prompt.hjson, SSL certs etc< / td >
< / tr >
< tr >
< td style = "text-align: left" > /enigma-bbs/db< / td >
< td style = "text-align: left" > ENiGMA databases< / td >
< / tr >
< tr >
< td style = "text-align: left" > /enigma-bbs/filebase< / td >
< td style = "text-align: left" > Filebase< / td >
< / tr >
< tr >
< td style = "text-align: left" > /enigma-bbs/logs< / td >
< td style = "text-align: left" > Logs< / td >
< / tr >
< tr >
< td style = "text-align: left" > /enigma-bbs/mods< / td >
< td style = "text-align: left" > ENiGMA mods< / td >
< / tr >
< tr >
< td style = "text-align: left" > /mail< / td >
< td style = "text-align: left" > FTN mail (for use with an external mailer)< / td >
< / tr >
< / tbody >
< / table >
< h2 id = "building-your-own-image" > Building your own image< / h2 >
< p > Customising the Docker image is easy!< / p >
< ol >
< li > Clone the ENiGMA-BBS source.< / li >
2022-08-19 06:04:01 +00:00
< li > Build the image
< div class = "language-bash highlighter-rouge" >
< div class = "highlight" > < pre class = "highlight" > < code > docker build < span class = "nt" > -f< / span > ./docker/Dockerfile < span class = "nb" > .< / span >
2022-02-05 06:30:33 +00:00
< / code > < / pre > < / div > < / div >
< / li >
< / ol >
< / div >
< div class = "PageNavigation" >
< a class = "btn" style = "float:left;margin-right: 20px;" href = "/enigma-bbs/installation/install-script.html" > « Install Script< / a >
< a class = "btn" style = "float: right;margin-left: 20px" href = "/enigma-bbs/installation/manual.html" > Manual Installation »< / a >
< br clear = "both" >
< / div >
< / section >
< / div >
< / div >
< / div >
< / body >
< / html >
