mirror of
				https://github.com/mail-in-a-box/mailinabox.git
				synced 2025-10-31 19:00:54 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			103 lines
		
	
	
		
			4.1 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
			
		
		
	
	
			103 lines
		
	
	
		
			4.1 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
| <style>
 | |
| </style>
 | |
| 
 | |
| <h2>Static Web Hosting</h2>
 | |
| 
 | |
| <p>This machine is serving a simple, static website at <a href="https://{{hostname}}">https://{{hostname}}</a> and at all domain names that you set up an email user or alias for.</p>
 | |
| 
 | |
| <h3>Uploading web files</h3>
 | |
| 
 | |
| <p>You can replace the default website with your own HTML pages and other static files. This control panel won’t help you design a website, but once you have <tt>.html</tt> files you can upload it following these instructions:</p>
 | |
| 
 | |
| <ol>
 | |
| <li>Ensure that any domains you are publishing a website for have no problems on the <a href="#system_status" onclick="return show_panel(this);">Status Checks</a> page.</li>
 | |
| 
 | |
| <li>On your personal computer, install an SSH file transfer program such as <a href="https://filezilla-project.org/">FileZilla</a> or <a href="http://linuxcommand.org/man_pages/scp1.html">scp</a>.</li>
 | |
| 
 | |
| <li>Log in to this machine with the file transfer program. The server is <strong>{{hostname}}</strong>, the protocol is SSH or SFTP, and use the <strong>SSH login credentials</strong> that you used when you originally created this machine at your cloud host provider. This is <strong>not</strong> what you use to log in either for email or this control panel. Your SSH credentials probably involves a private key file.</li>
 | |
| 
 | |
| <li>Upload your <tt>.html</tt> or other files to the directory <tt>{{storage_root}}/www/default</tt> on this machine. They will appear directly and immediately on the web.</li>
 | |
| 
 | |
| <li>The websites set up on this machine are listed in the table below with where to put the files for each website (if you have customized that, see next section).</li>
 | |
| 
 | |
| <table id="web_domains_existing" class="table" style="margin-bottom: 2em; width: auto;">
 | |
|         <thead>
 | |
|                 <tr>
 | |
|                         <th>Site</th>
 | |
|                         <th>Directory for Files</th>
 | |
|                 </tr>
 | |
|         </thead>
 | |
|         <tbody>
 | |
|         </tbody>
 | |
| </table>
 | |
| 
 | |
| <li>If you want to have this box host a static website on a domain that is not listed in the table, create a dummy <a href="#users" onclick="return show_panel(this);">mail user</a> or <a href="#aliases" onclick="return show_panel(this);">alias</a> on the domain first.</li>
 | |
| 
 | |
| </ol>
 | |
| 
 | |
| <h3>Different sites for different domains</h3>
 | |
| 
 | |
| <p>Create one of the directories shown in the table below to create a space for different files for one of the websites.</p>
 | |
| 
 | |
| <p>After you create one of these directories, click <button id="web_update" class="btn btn-primary" onclick="do_web_update()">Web Update</button> to restart the box’s web server so that it sees the new website file location.</p>
 | |
| 
 | |
| <table id="web_domains_custom" class="table" style="margin-bottom: 2em; width: auto;">
 | |
|         <thead>
 | |
|                 <tr>
 | |
|                         <th>Site</th>
 | |
|                         <th>Create Directory</th>
 | |
|                 </tr>
 | |
|         </thead>
 | |
|         <tbody>
 | |
|         </tbody>
 | |
| </table>
 | |
| 
 | |
| 
 | |
| <script>
 | |
| function show_web() {
 | |
|  api(
 | |
|     "/web/domains",
 | |
|     "GET",
 | |
|     {
 | |
|     },
 | |
|     function(domains) {
 | |
| 	var tb = $('#web_domains_existing tbody');
 | |
| 	tb.text('');
 | |
| 	for (var i = 0; i < domains.length; i++) {
 | |
| 		var row = $("<tr><th class='domain'><a href=''></a></th><td class='directory'><tt/></td></tr>");
 | |
| 		tb.append(row);
 | |
| 		row.find('.domain a').text('https://' + domains[i].domain);
 | |
| 		row.find('.domain a').attr('href', 'https://' + domains[i].domain);
 | |
| 		row.find('.directory tt').text(domains[i].root);
 | |
| 	}
 | |
| 
 | |
| 	tb = $('#web_domains_custom tbody');
 | |
| 	tb.text('');
 | |
| 	for (var i = 0; i < domains.length; i++) {
 | |
| 		if (domains[i].root != domains[i].custom_root) {
 | |
| 			var row = $("<tr><th class='domain'><a href=''></a></th><td class='directory'><tt></td></tr>");
 | |
| 			tb.append(row);
 | |
| 			row.find('.domain a').text('https://' + domains[i].domain);
 | |
| 			row.find('.domain a').attr('href', 'https://' + domains[i].domain);
 | |
| 			row.find('.directory tt').text(domains[i].custom_root);
 | |
| 		}
 | |
| 	}
 | |
|     });
 | |
| }
 | |
| 
 | |
| function do_web_update() {
 | |
|  api(
 | |
|     "/web/update",
 | |
|     "POST",
 | |
|     {
 | |
|     },
 | |
|     function(data) {
 | |
|       if (data == "")
 | |
|         data = "Nothing changed.";
 | |
|       else
 | |
|         data = $("<pre/>").text(data);
 | |
|       show_modal_error("Web Update", data, function() { show_web() });
 | |
|     });
 | |
| }
 | |
| </script>
 |