Bubbles

Bubbles the simple, easy to use HTTP web server that is browser controlled, and capable of serving static files over the internet, either streamed from disk, or direct from RAM without lag.

A GUI administration panel is accessed through your web browser (e.g. "http://localhost:1080/admin/" + default password of "admin"), which controls all her settings and vital functions, all in realtime.

Apart from serving files, she is capable of tracking site visits (site counters), receiving emails, accepting contact form submissions with support for Spam Guard, and recording site activity as date stamped traffic logs. She also includes a built-in log analyser for making sense of her traffic logs. These and other features make her more than capable of running multiple websites with little to no headache.

Her design is light and stable, and an extensive block-based memory management system ensures all her key operations use memory in a sustained and reliable manner.

Free, fully functional, portable software program, with no installation or setup.  Your existing computer libraries/files remain unchanged/unmodified.  We take pride in this respect function.

Tip:
Bubbles is portable and will run from within the folder you downloaded it to.

Features





Information

Name
Bubbles
Version
3.00.9220
Edition
Standard
Type
Console Application
Classification
Free for personal and business use
Status
New
Release Date
2nd May 2024
Portable
Yes
Code Foundation
4th Generation (Gossamer for Console)
Operating System(s)
Microsoft Windows 95-11 and Windows Server

bubbles-screenshot (JPG image)Overview critical website information, current bandwidth consumption, and hit values.
bubbles-screenshot2 (JPG image)Inbox lists your messages in the left panel with the most recent messages sorted from topmost to bottommost.  Click a message to view it on the right.
bubbles-screenshot3 (JPG image)Easily restore accidentally deleted messages back to the inbox, or delete individual messages permanently, or clear the entire trash folder in one go.
bubbles-screenshot4 (JPG image)Click on a traffic log in the left panel to view a realtime report on the right.
bubbles-screenshot5 (JPG image)View technical information in realtime in a virtual command prompt window.
bubbles-screenshot6 (JPG image)Adjust important server settings on-the-fly without the need to restart or access the command prompt.
bubbles-screenshot7 (JPG image)Apply limits to how a client's web browser accesses your website(s).  For instance, bandwidth and hit limits.
bubbles-screenshot8 (JPG image)Override the built-in mime types, or enter new ones with the mime type manager.
bubbles-screenshot9 (JPG image)Type your own contact form response messages.  Enable "Spam Guard" to protect your contact form from mass spam.  Start/stop the email server (SMTP).
bubbles-screenshot10 (JPG image)Quickly and easily reroute domain traiffic.
bubbles-screenshot11 (JPG image)Manage one or more websites from your browser.
bubbles-screenshot12 (JPG image)Modify a website's contents by uploading files from your hard drive.  Delete unwanted files.  And list files to see what's where.  And easily adjust its hit counter.
bubbles-screenshot13 (JPG image)Need help?  Browse through Bubbles' built-in offline help anytime without the need for internet access.
What is Bubbles, and what does she do?Help TopicsShe is a simple, easy to use HTTP web server that is browser controlled, and capable of serving static files over the internet, either streamed from disk, or direct from RAM without lag.

Her GUI administration panel is accessed through your web browser (e.g. "http://localhost:1080/admin/" + default password of "admin"), which controls all her settings and vital functions, all in realtime.

Apart from serving files, she is capable of tracking site visits (site counters), receiving emails, accepting contact form submissions with support for Spam Guard, and recording site activity as date stamped traffic logs.  She also includes a built-in log analyser for making sense of her traffic logs.  These and other features make her more than capable of running multiple websites with little to no headache.

Her design is light and stable, and an extensive block-based memory management system ensures all her key operations use memory in a sustained and reliable manner.

FeaturesHelp Topics
Running Bubbles for the first timeHelp TopicsIf you intend to run Bubbles facing the internet, you should change the default password (admin) before starting her.  To do this, run Bubbles from the command line like so, and replace <new password> with a unique password of your choice:
bubbles --password <new password>

Or from PowerShell:
.\bubbles --password <new password>

Command Line SupportHelp TopicsFor detailed help type:
bubbles --help

This will list every command option Bubbles supports along with help.  Scroll to the top of your console window to view the first help topic.

To list the commands Bubbles supports type:
bubbles --commands

For an information summary type:
bubbles --info

For help on a specific command type:
bubbles --help:<command name>

Example:
bubbles --help:port

This displays help on how to set the port number for the HTTP server.

Commands may be 'stacked' to execute more than one in a single go.

Examples:
bubbles --port 80 --password abcde --cachesize 1100 --filesize 500,000 --info
bubbles --port 80 --password abcde --cachesize 1100 --filesize 500,000 --info --run
bubbles --port 80 --password abcde --run --cachesize 1100 --filesize 500,000 --info

Example 1 sets the HTTP broadcast port to 80, the password to abcde, cachesize to 1.1 GB, file size to 500 KB and finally lists an information summary. Example 2 performs the same operations, but the last command then instructs the server to run and begin broadcasting. Example 3 sets the port and password, then runs the server, ignoring all commands after --run.

How to access the administration panel with your browserHelp TopicsMake sure Bubbles is running.  With your browser navigate to http://localhost:1080/admin/ (or the port your Bubbles is listening on).

A login window will prompt for a password.  Enter your password (default is "admin") and click the login button.  The administration panel will display.

Security Notice:
To login successfully and remain logged in, Bubbles requires your browser to support cookies with a constant (unchanging) user agent.  Should either of these parameters fluctuate you'll be logged out and a security notice deposited in your Inbox warning of unauthorised activity.

Web Administration - OverviewHelp TopicsThe overview tab has four summary tables.

The first, Daily Summary, displays the hits and bandwidth consumed per domain (website) for the last 24 hours, resetting at midnight.

Next is Server Stats, a table of critical information about the server's current state, such as last load time, uptime and bandwidth consumed, as well as the number of active connections.

The third table, Site Stats, lists each domain (website) along with the total hits, files and memory usage.  Lastly, the About table provides information pertaining to Bubbles, such as version number and size on disk.

At the top and bottom of the page are three buttons:

Web Administration - InboxHelp TopicsYour Inbox is where all inbound emails and contact form submissions are deposited.  The panel defaults to a left column with the date, subject and options, and the email body on the right.  Narrowing the browser switches the view to top and bottom.

Click the subject line of the message to view.  To download the email, click the "EML" link.  Message downloads in the standard email format ".eml", including the message and any attachments and additional information.

To move the email to the Trash folder, click the "Del" link.  On the right a confirmation message will display.  To undelete the email, click the "Restore to Inbox" button in the message on the right.

The 500 most recent emails are displayed from top (most recent) to bottom (least recent) order.  Older emails are stored on page 2, 3 etc.  Each new page can hold an additional 500 emails.

To refresh the inbox list, click the "Inbox" tab at the top of the page, or hit the refresh button on your browser.

Web Administration - TrashHelp TopicsThe Trash folder is laid out identically to the Inbox with the addition of a "Delete All Messages..." button (top of window).  Clicking this button will prompt for delete confirmation.  Proceeding, deletes all messages from all pages of the Trash folder permanently.

If a message is in your Trash folder but shouldn't be, you can restore it by clicking the "Res" link (restore).  A message will display stating the message has been restored to your inbox.  Again, like the Inbox, this action can be reversed (cancelled) by clicking the "Delete to Trash" button (on the right), which moves the message back to the Trash folder.

To refresh the Trash folder list, click the "Trash" tab at the top of the page, or click the refresh button on your browser.

Web Administration - LogsHelp TopicsIf raw traffic logs are enabled (see Settings tab), then a date named entry will appear for each day of traffic logs.

To view a particular day's log, scroll to the day in question and click its link.  A new tab will open in your browser with the day's log.

Each day's log updates regularly on 5 second intervals, when traffic is present.  Reloading the tab on your browser will update the log's display.

Raw traffic logs comprise of lines of text, one line of text per request to either the HTTP server or the SMTP server, from the oldest entry (top) to the most recent entry (bottom).

An example snippet of a raw traffic log:
127.0.0.1 - - [29/Mar/2024:01:02:44 +1030] "GET /www_blaizenterprises_com/about-animator.png HTTP/1.1" 200 9340 "http://localhost:1080/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [1ms 28u 2c]
127.0.0.1 - - [29/Mar/2024:01:02:44 +1030] "GET /www_blaizenterprises_com/banner-about.jpg HTTP/1.1" 200 39524 "http://localhost:1080/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [1ms 4u 6c]
127.0.0.1 - - [29/Mar/2024:01:02:44 +1030] "GET /www_blaizenterprises_com/banner-fun.jpg HTTP/1.1" 200 116013 "http://localhost:1080/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [52ms 4u 7c]
127.0.0.1 - - [29/Mar/2024:01:02:44 +1030] "GET /www_blaizenterprises_com/about-ubuntu.jpg HTTP/1.1" 200 122473 "http://localhost:1080/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [47ms 12u 3c]
127.0.0.1 - - [29/Mar/2024:01:02:44 +1030] "GET /www_blaizenterprises_com/oscar.jpg HTTP/1.1" 200 91071 "http://localhost:1080/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [46ms 11u 4c]
127.0.0.1 - - [29/Mar/2024:01:02:44 +1030] "GET /www_blaizenterprises_com/banner-colors.jpg HTTP/1.1" 200 81544 "http://localhost:1080/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [45ms 3u 5c]
127.0.0.1 - - [29/Mar/2024:01:02:45 +1030] "GET /www_blaizenterprises_com/about-eat.png HTTP/1.1" 200 38690 "http://localhost:1080/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [1ms 29u 2c]
127.0.0.1 - - [29/Mar/2024:01:02:45 +1030] "GET /www_blaizenterprises_com/about-dsd.png HTTP/1.1" 200 73460 "http://localhost:1080/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [31ms 5u 6c]
127.0.0.1 - - [29/Mar/2024:01:02:45 +1030] "GET /www_blaizenterprises_com/.hits.png HTTP/1.1" 200 759 "http://localhost:1080/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [0ms 12u 4c]
127.0.0.1 - - [29/Mar/2024:01:02:45 +1030] "GET /www_blaizenterprises_com/about-dougi.jpg HTTP/1.1" 200 185068 "http://localhost:1080/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [78ms 13u 3c]
127.0.0.1 - - [29/Mar/2024:01:02:46 +1030] "GET /www_blaizenterprises_com/pickzoom.html HTTP/1.1" 200 34741 "http://localhost:1080/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [0ms 14u 3c]
127.0.0.1 - - [29/Mar/2024:01:02:46 +1030] "GET /www_blaizenterprises_com/sflogo.png HTTP/1.1" 200 14372 "http://localhost:1080/pickzoom.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [0ms 30u 2c]
127.0.0.1 - - [29/Mar/2024:01:02:46 +1030] "GET /www_blaizenterprises_com/.hits.png HTTP/1.1" 200 759 "http://localhost:1080/pickzoom.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [1ms 13u 4c]
127.0.0.1 - - [29/Mar/2024:01:02:46 +1030] "GET /www_blaizenterprises_com/ghlogo.png HTTP/1.1" 200 2525 "http://localhost:1080/pickzoom.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [0ms 4u 5c]
127.0.0.1 - - [29/Mar/2024:01:02:46 +1030] "GET /www_blaizenterprises_com/pickzoom.png HTTP/1.1" 200 246 "http://localhost:1080/pickzoom.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [0ms 6u 6c]
127.0.0.1 - - [29/Mar/2024:01:02:46 +1030] "GET /www_blaizenterprises_com/pickzoom-screenshot.jpg HTTP/1.1" 200 138300 "http://localhost:1080/pickzoom.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [32ms 15u 3c]
127.0.0.1 - - [29/Mar/2024:01:02:50 +1030] "GET /www_blaizenterprises_com/pickzoom-screenshot2.jpg HTTP/1.1" 200 178493 "http://localhost:1080/pickzoom.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [62ms 16u 3c]
127.0.0.1 - - [29/Mar/2024:01:02:52 +1030] "GET /www_blaizenterprises_com/pickzoom.7z HTTP/1.1" 200 424340 "http://localhost:1080/pickzoom.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [174ms 17u 3c]
127.0.0.1 - - [29/Mar/2024:01:02:54 +1030] "GET /www_blaizenterprises_com/pickzoom.zip HTTP/1.1" 200 591587 "http://localhost:1080/pickzoom.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [297ms 18u 3c]
127.0.0.1 - - [29/Mar/2024:01:02:55 +1030] "GET /www_blaizenterprises_com/pickzoom.exe HTTP/1.1" 200 1311744 "http://localhost:1080/pickzoom.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [646ms 19u 3c]
127.0.0.1 - - [29/Mar/2024:01:02:55 +1030] "GET /www_blaizenterprises_com/index.html HTTP/1.1" 200 89133 "http://localhost:1080/pickzoom.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [32ms 20u 3c]
127.0.0.1 - - [29/Mar/2024:01:02:55 +1030] "GET /www_blaizenterprises_com/.hits.png HTTP/1.1" 200 752 "http://localhost:1080/index.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [0ms 21u 3c]
127.0.0.1 - - [29/Mar/2024:01:02:57 +1030] "GET /www_blaizenterprises_com/harmony.html HTTP/1.1" 200 135533 "http://localhost:1080/index.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [31ms 22u 3c]
127.0.0.1 - - [29/Mar/2024:01:02:57 +1030] "GET /www_blaizenterprises_com/harmony.png HTTP/1.1" 200 362 "http://localhost:1080/harmony.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [0ms 23u 3c]
127.0.0.1 - - [29/Mar/2024:01:02:57 +1030] "GET /www_blaizenterprises_com/.hits.png HTTP/1.1" 200 752 "http://localhost:1080/harmony.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [0ms 14u 4c]
127.0.0.1 - - [29/Mar/2024:01:02:57 +1030] "GET /www_blaizenterprises_com/softpedia.png HTTP/1.1" 200 12066 "http://localhost:1080/harmony.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [1ms 5u 5c]
127.0.0.1 - - [29/Mar/2024:01:02:57 +1030] "GET /www_blaizenterprises_com/harmony-screenshot.jpg HTTP/1.1" 200 117759 "http://localhost:1080/harmony.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [80ms 7u 6c]
127.0.0.1 - - [29/Mar/2024:01:02:59 +1030] "GET /www_blaizenterprises_com/harmony-screenshot2.jpg HTTP/1.1" 200 209164 "http://localhost:1080/harmony.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [63ms 6u 5c]
127.0.0.1 - - [29/Mar/2024:01:02:59 +1030] "GET /www_blaizenterprises_com/harmony-screenshot3.jpg HTTP/1.1" 200 213714 "http://localhost:1080/harmony.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [110ms 7u 5c]
127.0.0.1 - - [29/Mar/2024:01:03:01 +1030] "GET /www_blaizenterprises_com/harmony.exe HTTP/1.1" 200 1448448 "http://localhost:1080/harmony.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [670ms 8u 5c]
127.0.0.1 - - [29/Mar/2024:01:03:03 +1030] "GET /www_blaizenterprises_com/.hits.png HTTP/1.1" 200 733 "http://localhost:1080/index.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [0ms 9u 5c]
127.0.0.1 - - [29/Mar/2024:01:03:12 +1030] "GET /www_blaizenterprises_com/blendit-screenshot5.gif HTTP/1.1" 200 16673 "http://localhost:1080/blendit.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [0ms 24u 3c]
127.0.0.1 - - [29/Mar/2024:01:03:12 +1030] "GET /www_blaizenterprises_com/blendit.html HTTP/1.1" 200 96034 "http://localhost:1080/index.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [32ms 10u 5c]
127.0.0.1 - - [29/Mar/2024:01:03:12 +1030] "GET /www_blaizenterprises_com/.hits.png HTTP/1.1" 200 733 "http://localhost:1080/blendit.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [1ms 31u 2c]
127.0.0.1 - - [29/Mar/2024:01:03:12 +1030] "GET /www_blaizenterprises_com/blendit.png HTTP/1.1" 200 415 "http://localhost:1080/blendit.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [0ms 25u 3c]
127.0.0.1 - - [29/Mar/2024:01:03:12 +1030] "GET /www_blaizenterprises_com/blendit-screenshot.jpg HTTP/1.1" 200 116786 "http://localhost:1080/blendit.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [32ms 15u 4c]
127.0.0.1 - - [29/Mar/2024:01:03:12 +1030] "GET /www_blaizenterprises_com/soft32.jpg HTTP/1.1" 200 1798 "http://localhost:1080/blendit.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [0ms 11u 5c]
127.0.0.1 - - [29/Mar/2024:01:03:12 +1030] "GET /www_blaizenterprises_com/blendit-screenshot2.jpg HTTP/1.1" 200 167664 "http://localhost:1080/blendit.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [79ms 8u 6c]
127.0.0.1 - - [29/Mar/2024:01:03:14 +1030] "GET /www_blaizenterprises_com/blendit-screenshot3.jpg HTTP/1.1" 200 179967 "http://localhost:1080/blendit.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [63ms 9u 6c]
127.0.0.1 - - [29/Mar/2024:01:03:16 +1030] "GET /www_blaizenterprises_com/blendit.zip HTTP/1.1" 200 601667 "http://localhost:1080/blendit.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [280ms 10u 6c]
127.0.0.1 - - [29/Mar/2024:01:03:17 +1030] "GET /www_blaizenterprises_com/.hits.png HTTP/1.1" 200 744 "http://localhost:1080/index.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [0ms 11u 6c]
127.0.0.1 - - [29/Mar/2024:01:03:19 +1030] "GET /www_blaizenterprises_com/cursors-yellow.html HTTP/1.1" 200 33858 "http://localhost:1080/index.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [0ms 12u 6c]
127.0.0.1 - - [29/Mar/2024:01:03:19 +1030] "GET /www_blaizenterprises_com/.hits.png HTTP/1.1" 200 744 "http://localhost:1080/cursors-yellow.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [0ms 12u 5c]
127.0.0.1 - - [29/Mar/2024:01:03:19 +1030] "GET /www_blaizenterprises_com/cursors-yellow.png HTTP/1.1" 200 1150 "http://localhost:1080/cursors-yellow.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [0ms 32u 2c]
127.0.0.1 - - [29/Mar/2024:01:03:19 +1030] "GET /www_blaizenterprises_com/cursors-yellow-screenshot2.jpg HTTP/1.1" 200 95793 "http://localhost:1080/cursors-yellow.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [31ms 26u 3c]
127.0.0.1 - - [29/Mar/2024:01:03:19 +1030] "GET /www_blaizenterprises_com/cursors-yellow-screenshot.jpg HTTP/1.1" 200 276213 "http://localhost:1080/cursors-yellow.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [110ms 13u 6c]
127.0.0.1 - - [29/Mar/2024:01:03:21 +1030] "GET /www_blaizenterprises_com/.hits.png HTTP/1.1" 200 744 "http://localhost:1080/index.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [0ms 14u 6c]
127.0.0.1 - - [29/Mar/2024:01:03:23 +1030] "GET /www_blaizenterprises_com/cursors-pink.html HTTP/1.1" 200 34302 "http://localhost:1080/index.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [0ms 15u 6c]
127.0.0.1 - - [29/Mar/2024:01:03:23 +1030] "GET /www_blaizenterprises_com/cursors-pink.png HTTP/1.1" 200 1313 "http://localhost:1080/cursors-pink.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [0ms 33u 2c]
127.0.0.1 - - [29/Mar/2024:01:03:23 +1030] "GET /www_blaizenterprises_com/.hits.png HTTP/1.1" 200 744 "http://localhost:1080/cursors-pink.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [0ms 27u 3c]
127.0.0.1 - - [29/Mar/2024:01:03:23 +1030] "GET /www_blaizenterprises_com/uptodown.jpg HTTP/1.1" 200 5712 "http://localhost:1080/cursors-pink.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [0ms 13u 5c]
127.0.0.1 - - [29/Mar/2024:01:03:23 +1030] "GET /www_blaizenterprises_com/cursors-pink-screenshot2.jpg HTTP/1.1" 200 153463 "http://localhost:1080/cursors-pink.html" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" [79ms 16u 4c]

A log entry (one line of text) takes the format of:

Web Administration - BanHelp TopicsThe Banned List panel details the IP addresses currently banned by Bubbles.  The six columns of the table represent client information:

When a client appears on the banned list they are denied access to all services hosted by Bubbles, e.g. websites / contact form / email server etc.

Clicking the "Unban All" button clears the banned list, and allows all clients in again.
                    IP Address   Posts  Bad Logins   Requests      Bandwidth       Time
                    ----------   -----  ----------   --------      ---------       ----
                       0.0.0.0       0           0        113       4.318 MB        01m
                           ::1       0           0        128       4.220 MB        00m

2 banned addresses found.

Web Administration - ConnHelp TopicsLists open connections and associated information.

Conn #   Type  Last Mode    Open Time    Idle Time    Use Count   Recycled     Last IP Address
------   ----  ---------    ---------    ---------    ---------   --------     ---------------
     2   HTTP      write          18s          02s            8         22           127.0.0.1
     3   HTTP      write          15s          14s            9         21             0.0.0.0
     4   HTTP       read          14s          00s            3         21             0.0.0.0
     5   HTTP      write          19s          02s           11         20           127.0.0.1
     7   HTTP      write          19s          02s            2         21           127.0.0.1
     8   HTTP      write          18s          02s           11         21           127.0.0.1
     9   HTTP      write          21s          02s            8         20           127.0.0.1
    10   HTTP      write          21s          02s            8         21           127.0.0.1
    11   HTTP      write          18s          02s            8         19           127.0.0.1
    12   HTTP      write          26s          18s            9         17                 ::1
    13   HTTP      write          18s          02s           13         15           127.0.0.1
    14   HTTP      write          18s          02s           12         11           127.0.0.1
    15   HTTP      write          15s          14s           26          6             0.0.0.0
    16   HTTP      write          27s          02s            8          5           127.0.0.1
    17   HTTP      write          15s          14s            8          6             0.0.0.0
    18   HTTP      write          14s          14s            3          4             0.0.0.0
    19   HTTP      write          14s          14s            2          5             0.0.0.0
    20   HTTP      write          27s          02s           14          3           127.0.0.1
    21   HTTP      write          14s          14s            2          4             0.0.0.0

19 open connections found.  Entires marked in red indicate no data in or out.

Web Administration - ConsoleHelp TopicsDisplays a command line view of critical realtime information.

The five buttons listed at the top and bottom of the page are from left to right:

Web Administration - SettingsHelp TopicsSet and adjust important server settings.

HTTP broadcast port

This is the port the web server listens on for inbound (client) connections, and is the port your browser uses to access Bubble's websites.

Max. Total Connections

The maximum number of connections that can be opened to Bubbles at any one time.  The connections are shared amongst all client's viewing your websites.

Max. RAM cache size

The upper limit of memory to be used in megabytes for storing static files for diskless access.  Diskless access avoids hard disk lag, a potential bottleneck for high volume traffic / frequently requested files.

Max. file size in bytes to store in RAM cache

Specifies how large a file can be in bytes (1,000,000 ~ 1 megabyte) before it is excluded from the RAM cache.  Small files are best cached.  Large gigabyte+ files are best left on disk.

Daily Bandwidth Quota (0=none, 10-N Mb)

Sets the maximum amount of bandwidth (upstream + downstream) that can be consumed in one 24 hour period.  Specified in megabytes (e.g. 1,000 Mb = 1 Gb and 1,000,000 Mb = 1 Tb).  When the quota is reached, all traffic in and out of Bubbles' is disabled, including all hosted websites, contact form, email, and Admin panel.  And her servers are switched off.

At midnight each night the quota is reset automatically and her servers switched back on.  Setting the quota to a value of 0 (zero) disables the quota checking feature, and permits unlimited bandwidth consumption.

Power Level

Sets an approximate CPU usage level for Bubbles.  The higher the level, the more CPU cycles she's permitted to use to fulfill client requests / stream data.  More CPU means faster turnarounds but at the cost of higher system stress.

If Bubbles is running on a single CPU / core / v-core system, then a high power level can starve other running services / processes of sufficient CPU cycles, especially during heavy loads, with the possible result of overall slower response performance or TTFB (time to first byte).

A power level of 5% uses the least amount of CPU and 100% the most CPU.

Backend server

Tick this option to use Bubbles as a backend server.  Under this condition, she will scan inbound headers for the client's IP address and other relevant information.

Only use this option when Bubbles is behind a trusted frontend server.  That is, one on the same local network as she is, so that there is no internet between her and the frontend server.  This way, hackers cannot interfere with the unencrypted network packets sent back and forth between the two servers.

Caddy as a frontend server is compatible with Bubbles, and provides easy to setup HTTPS, allowing for secure, encrypted access to Bubbles' hosted websites and contents, as well as offering a secure pathway to her web administration panel.

It should also be noted that running Bubbles as a backend server, typically requires the connections made between the two servers (front and back) to remain open, often for very long periods of time, regardless of the data being transmitted.  In which case the "Shut idle connections (2m)" option must be unticked for her to keep her connections open with the frontend server.

Mark site content as cacheable to browsers (2h)

When ticked, instructs the browser to keep a copy of the website in its local cache, reducing the total number of requests made to Bubbles as a user traverses a website.

Strict content security policy

Inserts the following security header when ticked for strict script and object handling:
Content-Security-Policy: script-src 'none'; object-src 'none'; base-uri 'none'; require-trusted-types-for 'script';

Bubbles daily summary notices (delivered to inbox)

Sends an email to her Inbox with a 24 hour summary of any website/s activity - hits and bandwidth, with the subject line "Bubbles - Daily Summary".

Bubbles quota notices (delivered to inbox)

Writes a "Bubbles - Quota Notice" to your Inbox whenever the daily bandwidth quota is reached.  The notice lets you know when exactly your quota was reached.

Bubbles reload notices (boot/reboot/reload - delivered to inbox)

Issues a boot, reboot or a reload notice when the RAM cache is refreshed by a command from the web administration panel (reload), or Bubbles is started / restarted from a machine boot / reboot.  The boot / reboot notice lets you know when your machine unexpectedly reboots.

Shut idle connections (2m)

Closes inbound server connections after two minutes of no data transfer.  Connections close immediately if the client closes a connection at its end.

A long delay of two minutes is sometimes required for slower connections where the client's ISP may download a large chunk of data for them and leave Bubbles waiting as the client continues to download from their ISP, before requesting the next chunk in the download stream.

This is especially true with bad connections, and in the case of dial-up level download speeds.

Folders alongside EXE

By default (not ticked), Bubbles maintains a folder alongside her EXE, e.g. "bubbles.exe_storage".  Subfolders are created within for your Inbox, Trash, Logs and disk sites (folders beginning with "www_").

This option should be used with caution, as changing it will affect all your websites, inbox, trash and log contents.  Though the location may change, nothing is deleted or lost, only the location where data is read from and written to changes.  All settings persist, regardless of this option's state.

Example - Not Ticked (default mode):

C:\Bubbles\bubbles.exe_storage\inbox
C:\Bubbles\bubbles.exe_storage\trash
C:\Bubbles\bubbles.exe_storage\logs
C:\Bubbles\bubbles.exe_storage\www_
C:\Bubbles\bubbles.exe_storage\www_blaizenterprises_com

Example - Ticked:

C:\Bubbles\inbox
C:\Bubbles\trash
C:\Bubbles\logs
C:\Bubbles\www_
C:\Bubbles\www_blaizenterprises_com

Record raw traffic logs

Writes an uncompressed plain text raw traffic log to disk for the day's traffic activity.  Each log is streamed to disk in near-realtime, chunk by chunk during the course of the day.  And data written to file is immediately accessible via the Logs panel.

If the server is very busy, a log may consume upwards of hundreds of megabytes.  Though a typical log will be less than ten megabytes for a single small website.

Traffic for all websites hosted by Bubbles is recorded into the same log file, and will contain the domain name of that website.  Emails too are logged, but instead of the HTTP protocol, are listed with the SMTP protocol.

No referrer info sent when downgrading from https to http

Instructs the client's browser not to send on any referrer url when following a link from your secure (https://) website to an external insecure (http://) website.  This is typical behaviour for a secure website.

Live stats via OS console window

Displays realtime information in the current Command Prompt / Console window.  This option will not work when Bubbles is running as a service, as Windows disables all GUI display, even text.

The display can always be viewed from the "Console" tab, no matter what mode Bubbles is running in.

Web Administration - LimitsHelp TopicsSet specific limits on a client's access, which if exceeded, will result in the client's IP address being banned for a set period of time.

Bubbles handles the banning and unbanning of client IP addresses automatically, for hassle free operation.

Scan for in minutes

This is the period of time, in minutes, Bubbles spends monitoring each client's IP address.  If any limit is exceeded within this set period of time, then the client's IP address will be marked as banned and all access to Bubbles and her services (websites, email, contact form etc) will be immediately denied with a 403 Access Forbidden error.

Ban for in minutes

Once a client's IP address is marked as banned (see above), it remains banned for the specified time period in minutes.

An Example:
Scan for in minutes = 1,440 (1 day)
Ban for in minutes = 10,080 (1 week)

In this situation, Bubbles will monitor all client IP addresses for 1,440 minutes, and if in that time frame any client exceeds a limit and is banned, they will be denied access to Bubbles and her services for a whole week.

This is just an example.  Both values can be set to wide values.  You could scan for 48 hours (2,880 minutes) and ban for a year (525,600 minutes).

When Bubbles is restarted / rebooted her ban list is reset, along with any and all previously banned IP addresses.

Hit limit

This differs from the graphical site hit counters.  Where the hit counters count every request to a .html or .htm document, this limit is based on requests to any file type made by the client.  The client's IP address will be banned once the limit is exceeded.

Post limit

This limits the number of combined emails sent to and contact form submissions made by a client.  If the limit is exceeded, the client's IP address is banned.

Example:
If the limit is set to 10, and the client sends 8 emails and submits 3 contact form messages, then on the third contact form submission they are banned.

Bandwidth limit in megabytes

Limits the bandwidth that can be consumed (upstream and downstream combined) before the client is banned.

Bad login limit

Specifies how many failed attempts at login can be made before the client is banned.  This guards against brute force password attacks.

Max. simultaneous connections

Restricts the number of connections a client may open to the server at any one time.  If this limit is exceeded, unlike the limits above, the client is not banned, but merely prevented from keeping the excessive connections open.

Web Administration - MimeHelp TopicsAdd or modify existing mime types.

Bubbles comes with 40+ predefined common mime types, and the option to override them, or add custom new mime types.  The one exception is the .html "text/html" mime type, which is always at least "text/html" for security and stability reasons.  It however can be appended to, for instance "html: text/html; charset=utf-8" (without quotes) is a valid customisation.

A console view below the text entry box displays the currently active mime types.  Items marked in red indicate a predefined mime type that has been modified, or a custom mime type.

File Type      Mime Type
---------      ---------
*              application/octet-stream
7z             application/x-7z-compressed
apk            application/vnd.android.package-archive
bmp            image/bmp
bwd            application/x-bwd
bwp            application/x-bwp
css            text/css
epub           application/epub+zip
exe            application/vnd.microsoft.portable-executable
gif            image/gif
gtar           application/x-gtar
gz             application/x-gzip
htm            text/html; charset=utf-8
html           text/html; charset=utf-8
ico            image/x-icon
jfif           image/jpeg
jif            image/jpeg
jpe            image/jpeg
jpeg           image/jpeg
jpg            image/jpeg
js             application/x-javascript
mid            audio/midi
midi           audio/midi
mkv            video/x-matroska
mocha          application/x-javascript
mp3            audio/mpeg
mp4            video/mp4
pdf            application/pdf
pl             application/x-perl
png            image/png
rtf            application/rtf
tar            application/x-tar
text           text/plain
tgz            application/x-compressed
tif            image/tiff
tiff           image/tiff
txt            text/plain
wav            audio/wav
weba           audio/webm
webm           video/webm
webp           image/webp
wma            audio/x-ms-wma
xhtml          application/xhtml+xml; charset=utf-8
xml            text/xml; charset=utf-8
z              application/x-compress
zip            application/zip

46 mime types found.  Entires marked in red indicate a custom mime type.
The "*" file type is the fallback mime type used for unknown file types.

Web Administration - ContactHelp TopicsManages contact form submissions and the SMTP (simple mail transport protocol) email server.

Allow Contact Form Submissions

Turns on the contact form handler, allowing contact form submissions via the "contact.html" file.  This is the only file permitted to submit a contact form message to Bubbles.

The form must use the "POST" method when sending its data to Bubbles.  If you intend to use the Spam Guard, use the "((spamguard))" (without quotes) tag to position it within your contact form code, otherwise Bubbles' will insert it at the bottom of your form.  There is an upload limit of 65K, but bear in mind that text entered into a browser form will be encoded and thus increase in size.  So the real upload limit is less than 65K.  Upon receipt of the form's data, the form handler writes the form data to your Inbox as a simple plain text email message, using these common variable names to format it:

"subject" for the email's subject line, uses "(no subject)" if none found.
"message" or "msg" for the message body.
"email" for the from field.

All other variable names and values are written at the bottom, below the message body of the email.  If one or all of the above variable names are missing, no error is raised, and the message is written to your Inbox as best as possible.

Once the message has been stored in your Inbox, the form handler looks to modify the "contact.html" page by inserting a small piece of html code in the form of a reply message.  It does this by searching through the source code of the "contact.html" page for the starting comment code "<!--reply-->" (without the quotes) and searches on to the endpoint "<!--endreply-->" (again without quotes).  If this block is found then the html code between the two is omitted and the reply message (html code) is inserted in its place.  If the code block is not found, then Bubbles takes her best guess and inserts the reply code where she deems fit.  The modified "contact.html" page is then sent on back to the client.

There a three possible reply messages:
1. Thank you for your online message - the message was stored in your Inbox without error
2. Your online message could not be processed - something went wrong and Bubbles was unable to save the message to your Inbox (disk full / disk error)
3. Unable to accept messages at this stage - this message is displayed on the "contact.html" page when the "Allow Contact Form Submissions" is not ticked (disabled).

Example code snippet from our website's contact form (contact.html):
Contact us with the online form below.  All fields are optional.<br>
<br>
<form method=post action="contact.html" class="left">
<div class="window">
<div class="text">
<!--reply-->
<label class="window-label" for="lsubject">Subject</label>
<input class="window-edit" name="subject" id="lsubject" value="">

<label class="window-label window-vpad" for="lname">Name</label>
<input class="window-edit" name="name" id="lname" value="">

<label class="window-label window-vpad" for="lemail">Email Address</label>
<input class="window-edit" name="email" id="lemail" value="">

<label class="window-label window-vpad" for="lmessage">Message &nbsp;<span style="font-size:75%;">(Limited to 500 characters)</span></label>
<textarea class="window-text" maxlength=500 id="lmessage" rows="8" wrap="yes" name="message"></textarea>

((spamguard))

<div class="center-margin" style="padding-top: 1rem;"><input class="button center-margin" style="width: 100%" type=submit value=" Send Message "></div>

<!--endreply-->
</div>
</div>
</form>

Protect against mass spam with Spam Guard

A simple maths problem mechanism to protect against mass unsolicited spam.  Spam Guard presents the user interacting with your online contact form a short maths problem which must be solved correctly.  An incorrect or unsolved contact form submission ends up in the Trash folder.  A message with a correct answer is saved to your Inbox.

Allow emails to be received and stored in the inbox

This turns on the SMTP (simple mail transport protocol) email server, which uses port 25 to receive unencrypted emails.

Max Email Size

Places a limit on the email size that can be transmitted to Bubbles.  The limit is passed on ahead of email transmission to email clients capable of supporting the limit.  In turn they'll warn their users about the upload limit size.

Mail domain name to report to email senders when receiving emails

This must be a domain that points to Bubble's static IP address.  For instance, if your site is called "http://www.mysite.net", then your email domain would be "mysite.net" (without the quotes) and all inbound emails would take the form "(some name)@mysite.net".

Unfortunately, the email protocol only supports one domain name per static IP address (the IP address of the machine Bubbles is running on facing the internet).  This is because the email protocol expects the server to tell the client its domain name first, before the client transmits any email information, so it's not possible for an email server to switch between domains as a HTTP web server is able to.

Web Administration - MapHelp TopicsReroute traffic from one domain to another.  Useful when you have multiple domains or sub-domains you wish to direct at a single website or several websites.

Can be used to redirect traffic from a broken website to a temporary one, or whilst maintenance work is being performed, minimising downtime.

Alterations take affect once the save button is pressed.  A table at the top of the page lists every known domain that is hosted with Bubbles, and it's routing resolution, and whether it successfully mapped.

You may map to bogus / non-existence domains, as long as those domains end up mapping back to a real site (disk site) on Bubbles.  The target site does not need to have an externally registered domain name.  A known disk site (local folder) is enough for Bubbles to map to.

An Example:
examplesite.com: bogus123.com
bogus123.com: mysite.net

Assuming that "examplesite.com" is a registered domain name (source domain) and "mysite.net" is at least a known site (disk site) on Bubbles and "bogus123.com" is a made up domain, then the mapping "examplesite.com > bogus123.com > mysite.net" still works.  All traffic from "examplesite.com" will be directed to "mysite.net".

The order of entries does not matter.  The above example can be reordered as below, and will still work:
bogus123.com: mysite.net
examplesite.com: bogus123.com

A domain is considered known to Bubbles when it has a disk site.  A disk site is simply a folder with the "www_" prefix in its name followed by the full domain name (dots to underscores).  The disk site for the domain "mysite.net" would be "www_mysite_net" (without the quotes) and "examplesite.com" would have the disk site "www_examplesite_com" (again with quotes).

The fallback disk site is "www_", and is where traffic is directed for unknown sites.

Web Administration - ManageHelp TopicsManage your websites from this one tab.  Create a site, delete a site, upload files to a site, list files on a site, delete files from a site, set a site's hit counter value, and edit a site's redirect entries.

Important Note:
Currently there is only support for managing files.  If your website requires sub-folders, then you will need to upload your file structure using a third party software solution, such as a secure FTP server and client.

Create Site / Disk Site

Type the full name of your domain into the box and click the "Create Site" button.  For example "mysite.net".  A mini console view will report status below.  If your site was successfully created, then a button with your Disk Site name on it will appear above in the "Manage Sites" list (top of page).

Delete Site / Disk Site

Type the name of the site to be deleted and click the "Delete Site" button.  The site must be empty to be deleted - this is to prevent accidental deletion of an entire website when valuable content is present.  Once your site has been deleted, scroll up to the "Manage Sites" section (top of page) and click the "Reload Site(s)" button to refresh the list and make your changes public.

Manage Sites

Click the "Reload Site(s)" button to refresh the list of sites (domains / websites) and apply any changes made to one or more sites during any management action, such as the uploading and deleting of files.

To manage a site, click its button from the list of site buttons.  The management tab will change view to now display six sections:
1. General
2. Upload Files
3. List Files
4. Delete Files
5. Hit Counters
6. Redirect Links

General

Displays RAM used by all sites and the number of files cached.  Click the "Reload Site(s)" button to update any changes made to a site via the "Upload Files" or "Delete Files" sections.

Upload Files

Upload one or more files to the current website.  Click the "Browse..." button (left) and select a single file, or click down away from the file list and drag to highlight multiple files with your mouse, or hold down the shift key and down arrow using your keyboard.  Click the "Open" button and click "Upload Files".

It can take a few moments to upload and decode your files depending on how much data is being uploaded.  Once complete, a console view will display with an "Upload Log" detailing each file's name, size and status.  If you're satisfied, go ahead and click the "Reload Site(s)" button to make your changes live.

List Files

Want to know exactly what files you have on your site?  Leave the box empty to list all files, or type a mask (or a complex mask) into the box for a specific set of files, and click the "List Files" button.  A console view will display below with a list of files.  Entries marked in red indicate a file not in the RAM cache, which will be streamed from disk when requested by a client.

A mask can be as simple as "*.zip", which will list all files with the extension ".zip".  A complex mask may have up to 2 asterisks per section, and multiple sections are separated by semicolons ";".

Examples of Complex Masks:
*doc*.html;*.htm;*a*z.xml
*.jpg;*.jif;*aab;*.gif
*.doc;*.txt;*.rtf

Delete Files

A mask typed into the List Files box will automatically be entered into the Delete Files box, and vice versa.

Type a mask or complex mask and click the "Delete Files..." button.  You will be prompted to either abort with a large red button, or continue on and delete the files permanently.

Deleting the files permanently removes them from disk, but not from the RAM cache.  You must scroll up and click the "Reload Site(s)" button to refresh the RAM cache and make your changes live.

Hit Counter

Each site (website / domain) has its own hit counter.  You can set it to any number you desire.  Changes take affect as soon as you press the "Save" button.

The hit counter will automatically increment each time a "html" or "htm" document is requested.  To show the counter on your website, use the html image tag to display the digital display (PNG image).

For Example:
<img src=".hits.png" alt="Hit Counter">

To display the total hits across all your websites:
<img src=".totalhits.png" alt="Hit Counter">

The site counter updates after a short delay for optimal performance, and is both font and graphics independent.

Redirect Links

Bubbles supports both simple 1:1 file redirection and 1:10 random redirection.

For a simple redirect (1:1) type a source filename followed by a destination filename/url in the format "(source filename):(space)(target filename/url)".  One redirect entry per line.

The source filename does not have to exist, but if it does, the redirect takes precedence.  From then on, when a client requests the source filename, they will be redirected to the target filename (local file on website) or a url (any url).

To create a random redirect from a list of up to 10 filenames / urls, type the source filename followed by colon and space and then a comma-space-tab separated list of filenames and / or urls, of which, one will be randomly selected during the redirect process.

There is a combined limit of 1,000 redirect entires across all sites.  That is, all sites and their redirects cannot number more than 1,000 in total.

Example 1:
test1.html: http://testsite.net/about.html

test1.html redirects to http://testsite.net/about.html

Example 2:
test2.html: index.html, contact.html, other.html

test2.html redirects to index.html, contact.html or other.html at random.

Example 3:
test3.html: index.html, http://testsite.net, https://mysite.com, other.html

test3.html redirects to index.html, http://testsite.net, https://mysite.com or other.html randomly.

Web Administration - PasswordHelp TopicsChange the Administration password.

Type or enter your current password into the first box, and then type your new password into the "Type new password" box.  A password must be at least five characters long.  Retype your new password into the "Confirm new password" box.  When you're sure, click the "Change Password" button.

The new password will take affect the next time you go to login.

Web Administration - LogoutHelp TopicsClick the "Logout" tab to logout of your current Admin session.  Admin sessions automatically logout after 48 hours (2 days) of inactivity.

HTTP / SMTP CodesHelp Topics
200 OK
206 Partial Content
221 Closing (SMTP)
250 OK (SMTP)
304 Not Modified
307 Temporary Redirect
308 Permanent Redirect
400 Bad Request
404 Not Found
403 Forbidden
412 Precondition Failed
413 Content Too Large
429 Too Many Requests
431 Request Header Fields Too Large
500 Command Unrecognised (SMTP)
502 Bad Gateway
503 Service Unavailable
507 Insufficient Storage
509 Bandwidth Limit Exceeded
554 Transaction Failed (SMTP)

Formats, Support and DesignHelp TopicsBubbles supports the HTTP/1.0 and some of the HTTP/1.1 hyper text transport protocol, and responds to the GET, HEAD and POST methods.

She supports resume and partial downloads (http code 206) using byte range, and complies with the keep-alive header for persistent connections.

Virtual hosting via the "host" header is supported, allowing her to host multiple websites and domains at once.

She uses Etags to signal file changes, and temporary redirection (http code 307) for redirect links.

Support for SMTP (simple mail transport protocol) on port 25 for receiving unencrypted emails, for both HELO and EHLO modes, the later supporting upload limit notification to client email software.

She does not support https, compression on-the-fly, gzip, chunking, scripts, plug-ins or extension modules.

Her design principle is to keep things light, simple and stable, and remain secure and robust.

Command line options and helpHelp TopicsBubbles supports a small subset of commands via the command prompt, which are designed to clearly and easily set her main settings for broadcasting.  For instance, her default password (admin) must be replaced with your own strong unique password, before making her live to the internet, otherwise you run the very real risk of hackers probing her admin panel and gaining entry.

Modern command line switches are used (--<name>), but support for legacy switching is also provided.  For instance, the two lines below do exactly the same thing:
bubbles --help
bubbles /help

Listed below is a complete list of Bubbles' command line support and associated help.  To view this in full at your command prompt, run Bubbles with the "--help" switch.


[ password ]
------------
Set the web panel admin password. The default password is set to &quot;admin&quot;. We strongly recommend the password be changed to a strong/unique password before exposing the server to the internet.

Usage:
bubbles --password &lt;a string of unique characters&gt;

Range:
A minimum of 5 characters

Examples:
bubbles --password 12345
bubbles --password Ajkd?t78%1_S
bubbles --password

Example 1 sets the password to &quot;12345&quot;, a weak password. The second sets it to a strong password. And the third defaults to &quot;admin&quot;.

Security Notice:
This web server supports the HTTP protcol, which does not encrypt data, consequently if you intend to use the web panel over the internet, we suggest you do so via a frontend server like Caddy. Caddy supports HTTPS which encrypts all inbound/outbound data and will keep your password and admin session secure from hackers.

[ connections ]
---------------
Set the maximum number of inbound connections. &nbsp;Default is 1,000.

Usage:
bubbles --connections &lt;a number&gt;

Range:
10..4,000

Examples:
bubbles --connections 500
bubbles --connections 3000
bubbles --connections 4000
bubbles --connections

Example 1 sets the maximum number of connections to 500. The second to 3,000. And the third to 4,000. The fourth defaults to 1,000.

[ port ]
--------
Set the broadcast port for the HTTP server. &nbsp;Default is port 1080.

Usage:
bubbles --port &lt;a number&gt;

Range:
2..65,535

Examples:
bubbles --port 80
bubbles --port 1080
bubbles --port 2000

Example 1 sets the port to 80, the standard port for http (insecure) web servers. The second sets it to broadcast on port 1080. And the third port 2000. Typically ports above 1024 require no special administration privileges.

[ smtp ]
--------
Set SMTP (simple mail transport protocol) mode. &nbsp;Default is disabled.

Usage:
bubbles --smtp &lt;a value, 0 or negative=disabled, 1 or higher=enabled&gt;

Examples:
bubbles --smtp 1
bubbles --smtp 100
bubbles --smtp 0
bubbles --smtp -10
bubbles --smtp

Examples 1 and 2 enable SMTP mode. &nbsp;Examples 3, 4 and 5 disable SMTP. The mail port used is port 25. All inbound mail is unencrypted. Emails are stored in the Inbox folder as *.eml files. All mail (email and contact form messages) are accessible from the Inbox tab of the web panel.

[ cachesize ]
-------------
Set the maximum RAM Cache Size. The cache stores files for rapid access without disk lag. The cache expands upto this size to accomodate files. When the cache is full, or a file is too large, it&#39;s left on disk and streamed out when requested.

Usage:
bubbles --cachesize &lt;size in MB (megabytes)&gt;

Range:
10..1,500

Examples:
bubbles --cachesize 50
bubbles --cachesize 250
bubbles --cachesize 1,500
bubbles --cachesize

Example 1 sets RAM cache to use 50 MB. The second 250 MB. &nbsp;The third to 1500 MB (1.5 GB). And the fourth defaults to 1200 MB (1.2 GB)

[ filesize ]
------------
Set the maximum file size threshold. All files at or below this size are loaded into the RAM cache. Larger files are streamed from disk when requested. Set to 0 (zero) to load any file size into cache.

Usage:
bubbles --filesize &lt;size in bytes&gt;

Range:
0..1,536,000,000 b

Examples:
bubbles --filesize 123,500
bubbles --filesize 1024000
bubbles --filesize 333
bubbles --filesize

Example 1 loads files of 123.5 KB or less into cache. &nbsp;The second 1 MB or less. &nbsp;The third to 333 bytes or less. And the fourth defaults to 10 MB.

[ quota ]
---------
Set the daily bandwidth quota. If the combined upstream (client -&gt; server) and downstream (server -&gt; client) bandwidth exceeds the quota limit, all traffic in and out of Bubbles is suspended until midnight. &nbsp;At midnight, daily bandwidth quota tracking begins afresh.

Usage:
bubbles --quota &lt;size in MB (megabytes)&gt;

Range:
0=Disabled (no limit), 10..N Mb

Examples:
bubbles --quota 250
bubbles --quota 1,000
bubbles --quota 3,000,000
bubbles --quota

Example 1 sets the daily bandwidth quota to 250 Mb. The second to 1 Gb (1,000 Mb). &nbsp;The third to 3 Tb (3,000,000 Mb). And the fourth defaults to 0, which disables quota tracking and allows any amount of bandwidth.

[ power ]
---------
Set power level for CPU usage. &nbsp;Default is 100.

Usage:
bubbles --power &lt;a number&gt;

Range:
0..100

Examples:
bubbles --power 1
bubbles --power 20
bubbles --power 30
bubbles --power 90
bubbles --power

Example 1 sets power level to 1%, which uses the least amount of CPU. &nbsp;The second sets it to 20%. The third to 30%. The fourth to 90%. And the fifth defaults to 100%. The higher the power level, the more CPU the server uses for request processing and file streaming. Be aware, if the server shares a single CPU/virtual core with another server like Caddy, then setting the power level too high may starve the other server of CPU cycles, and result in a slower than expected request-response transaction. When run with admin privileges, e.g. as a service, the server automatically steps up to a higher thread priority.

[ logs ]
--------
Set raw traffic logging. &nbsp;Default is enabled.

Usage:
bubbles --logs &lt;a value, 0 or negative=disabled, 1 or higher=enabled&gt;

Examples:
bubbles --logs 1
bubbles --logs 100
bubbles --logs
bubbles --logs 0
bubbles --logs -10

Examples 1, 2 and 3 enable raw traffic logs. Examples 4 and 5 disable raw traffic logs. When raw traffic logs are enabled, all request activity on the server is recorded in a daily log file (*.txt) in the Logs folder. Log files can be accessed from the Logs tab on the web panel.

[ live ]
--------
Set live stats mode (console window). &nbsp;Default is enabled.

Usage:
bubbles --live &lt;a value, 0 or negative=disabled, 1 or higher=enabled&gt;

Examples:
bubbles --live 1
bubbles --live 100
bubbles --live
bubbles --live 0
bubbles --live -10

Examples 1, 2 and 3 enable live stats. Examples 4 and 5 disable live stats. When enabled, basic realtime information is rendered to the console window. This window can also be accessed anytime (even when live stats are disabled) from the Console tab of the web panel.

[ install ]
-----------
Install Bubbles as a service.
bubbles --install

Installs the server as a service with the following parameters:
Name: Bubbles Multi-Function Server
Display Name: Bubbles Multi-Function Server
Description: HTTP/1, SMTP, web panel, web mail, virtual hosting, domain mapping, redirector, logs + reports, contact form and site counters

[ uninstall ]
-------------
Uninstall Bubbles as a service.
bubbles --uninstall

Removes the server from the services list.

[ info ]
--------
Display basic settings in a easy to view summary.

Usage:
bubbles --info

[ commands ]
------------
List supported commands.

Usage:
bubbles --commands

[ run ]
-------
Runs the server.

Usage:
bubbles --run

Examples:
bubbles --port 80 --password abcde --run
bubbles --port 80 --password abcde --run --cachesize 1100
bubbles --run
bubbles

Example 1 sets port to 80, password to abcde, and then runs the server. The second does the same, but all commands after --run are ignored, --cachesize is never executed. Both 1 and 2 are examples of command stacking. Examples 3 and 4 run the server.

[ help ]
--------
Get help for a specific command.

Usage:
bubbles --help:&lt;command name&gt;

Examples:
bubbles --help:password
bubbles --help:port

Example 1 displays help for the Password command. &nbsp;Example 2 for the Port command.

[ rawhelp ]
-----------

Generate encoded version of help for Claude website builder. &nbsp;Output can be piped (saved) to a text file.

Example:
bubbles --rawhelp &gt; 1.txt

[ How To ]
----------

To list all help topics:
bubbles --help

To list help for a specific command:
bubbles --help:&lt;command name&gt;

An example for the port command:
bubbles --help:port

Available commands:
password
connections
port
smtp
cachesize
filesize
quota
power
logs
live
install
uninstall
info
commands
run
help
rawhelp
howto

Stacked commands:
Commands may be stacked in sequence, and are processed in left to right order.

Examples:
bubbles --port 80 --password abcde --cachesize 1100 --filesize 500,000 --info
bubbles --port 80 --password abcde --cachesize 1100 --filesize 500,000 --info --run
bubbles --port 80 --password abcde --run --cachesize 1100 --filesize 500,000 --info

Example 1 sets the HTTP broadcast port to 80, the password to abcde, cachesize to 1.1 GB, file size to 500 KB and finally lists an information summary. Example 2 performs the same operations, but the last command then instructs the server to run and begin broadcasting. Example 3 sets the port and password, then runs the server, ignoring all commands after --run.

LicenseHelp TopicsMIT License

Copyright 2024 Blaiz Enterprises

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Instagram Facebook Mastodon Twitter SourceForge GitHub Light Theme Privacy Policy Contact
© 1997-2024 Blaiz Enterprises No javascript. No cookies.
Site served by Caddy and Bubbles
Code curated by Claude
Hit Counter